Skip to main content

aimarket-oracle-gateway — MCP server

CI aimarket-oracle-gateway MCP server Test coverage License: MIT

One MCP server. Seventeen oracle families. Pay-per-call.

Transport: stdio (aimarket_oracle_gateway/stdio_server.py). Built with the official Model Context Protocol Python SDK (mcp, FastMCP). Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio servers.

Item Location
MCP entrypoint aimarket_oracle_gateway/stdio_server.py
Tool routing core aimarket_oracle_gateway/gateway_core.py
Extended tool surface aimarket_oracle_gateway/mcp_tool_surface.py
Glama / Docker run Dockerfile, glama.json

A passthrough MCP server — the discovery + consumption storefront for the entire oracle-as-a-service specs. One server, 35 tools, every result independently verifiable (signatures, VDF proofs, classical certificates, deterministic replay).

Tools (35)

Category MCP tool capabilityId price
Randomness get_random platon.random@v1 $0.004
get_randomness_beacon platon.beacon@v1 $0.004
ask_oracle platon.ask@v1 $0.003
verify_random platon.verify@v1 $0.001
Delay compute_vdf chronos.eval@v1 $0.01
verify_vdf chronos.verify@v1 $0.001
Reputation get_reputation_scores lumen.reputation@v1 $0.005
get_agent_trust lumen.score@v1 $0.003
verify_reputation lumen.verify@v1 $0.002
Consensus aggregate_values murmuration.aggregate@v1 $0.002
Thermodynamics audit_compute_cost landauer.audit@v1 $0.01
verify_compute_cost landauer.verify@v1 $0.001
Routing compute_least_time_route fermat.route@v1 $0.01
verify_least_time_route fermat.verify@v1 $0.001
Cascade risk analyze_cascade_risk ablation.cascade@v1 $0.01
verify_cascade_risk ablation.verify@v1 $0.001
Sampling get_quasirandom_sequence lattice.sequence@v1 $0.002
get_blue_noise turing.bluenoise@v1 $0.002
Optimization optimize_route colony.optimize@v1 $0.005
Resilience analyze_network_resilience percola.threshold@v1 $0.01
verify_network_resilience percola.verify@v1 $0.001
Randomness sortes_draw sortes.draw@v1 $0.006
sortes_verify sortes.verify@v1 $0.001
Learning gauss_field gauss.field@v1 $0.006
gauss_suggest gauss.suggest@v1 $0.006
gauss_verify gauss.verify@v1 $0.001
Time-lock aestus_seal aestus.seal@v1 $0.006
aestus_open aestus.open@v1 $0.01
aestus_verify aestus.verify@v1 $0.001
Topology betti_homology betti.homology@v1 $0.008
betti_distance betti.distance@v1 $0.004
Transport kantor_transport kantor.transport@v1 $0.006
kantor_verify kantor.verify@v1 $0.001
Spectral fourier_spectrum fourier.spectrum@v1 $0.005
fourier_verify fourier.verify@v1 $0.001
Discovery list_oracle_capabilities — free

Subscription tiers (optional Hub bundles)

High-volume tools also advertise monthly bundles in list_oracle_capabilities:

Tool Starter Pro
aggregate_values 10k calls / $10 100k / $50
get_reputation_scores 5k / $20 50k / $100
audit_compute_cost 10k / $15 100k / $75
compute_least_time_route 10k / $25 100k / $120
analyze_cascade_risk 5k / $50 50k / $250

Pay-per-call remains the default; bundles are Hub-side packaging.

Configure (env)

var meaning
AIMARKET_HUB_URL AIMarket Hub base URL — recommended: metered + paid
AIMARKET_ORACLE_URL direct oracle-family URL (if no hub) — demo/free path
AIMARKET_PAYMENT_CHANNEL optional pre-opened payment channel id
AIMARKET_PAYMENT_CHANNEL_SECRET per-channel debit secret
AIMARKET_API_TOKEN optional bearer token
AIMARKET_MAX_PER_CALL_USD hard cap per call (default 0.10)
AIMARKET_MAX_SPEND_USD hard cumulative budget (default 5.0)
AIMARKET_PRICE_TOLERANCE reject overcharge vs advertised (default 0.10)

If neither URL is set the server fails closed with a clear message.

Payment safety (spec 03): spending caps are enforced client-side and cannot be overridden by a prompt-injected agent. See docs/specs/03-mcp-payment-and-security.md.

Run

pip install -r requirements-mcp.txt && pip install --no-deps -e .
AIMARKET_HUB_URL=https://modelmarket.dev python -m aimarket_oracle_gateway.stdio_server

Claude Desktop (mcpServers entry):

{ "mcpServers": { "aimarket-oracle-gateway": {
  "command": "python", "args": ["-m", "aimarket_oracle_gateway.stdio_server"],
  "env": { "AIMARKET_HUB_URL": "https://modelmarket.dev" } } } }

Publish on Glama

Listing: glama.ai/mcp/servers/alexar76/aimarket-oracle-gateway

Verifiability

  • Platon — Ed25519 signature over (random_hex ‖ proof)
  • Chronos — Wesolowski VDF proof, cheap verify_vdf
  • LUMEN — re-derive PageRank from committed graph
  • Murmuration — deterministic re-aggregation from input values
  • Landauer — bit-for-bit erasure count from ops DAG + circuit_commitment
  • Fermat — dual certificate T(v) checked in O(E)
  • Ablation — sandpile replay, order-independent topple_total + tau
  • Lattice / Turing — deterministic from (count, dim, skip) / seed
  • Colony — admissible lower_bound + gap certificate
  • Percola — recomputable percolation sweep + f_c
  • Sortes — ECVRF 80-byte proof, verifiable offline by anyone (RFC 9381)
  • Gauss — deterministic replay of GP posterior + Expected-Improvement suggestion
  • Aestus — RSW time-lock puzzle re-derivable; modulus factorization burned each seal
  • Betti — recomputable Vietoris-Rips persistence diagram + bottleneck distance
  • Kantor — Kantorovich dual potentials checked in O(m*n) without re-solving
  • Fourier — recomputable Laplacian spectrum + Fiedler value lambda-2

Tests

PYTHONPATH=. pytest tests/

Metadata

Release files for aimarket-oracle-gateway 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aimarket-oracle-gateway 0.3.0
File Size Uploaded
aimarket_oracle_gateway-0.3.0.tar.gz 25.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aimarket-oracle-gateway 0.3.0
File Interpreter ABI Platform
aimarket_oracle_gateway-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 47.2 kB

Release files / aimarket_oracle_gateway-0.3.0.tar.gz

Download URL aimarket_oracle_gateway-0.3.0.tar.gz
Size 25.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9ee50907b981630c8a5d95c0ad73fd76dad34dc95973137d6daeb0d9de3f546d
BLAKE2b-256 checksum
How to use checksums
cfc48431b128b4f5883f993b0dd9cd59b882b449c4dfc4fa5a6dbe56c31dfe33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / aimarket_oracle_gateway-0.3.0-py3-none-any.whl

Download URL aimarket_oracle_gateway-0.3.0-py3-none-any.whl
Size 22.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c103d6d1f0e2e645511c061409f4c8995ae67bf8e32baed452fcfd8705ebd744
BLAKE2b-256 checksum
How to use checksums
9e4bccbd6b9833ae452d1ec4895e6240d9282bc6e7fdf03d0332c9cbeef63dac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page