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/

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aimarket_oracle_gateway-0.3.0.tar.gz (25.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aimarket_oracle_gateway-0.3.0-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

Details for the file aimarket_oracle_gateway-0.3.0.tar.gz.

File metadata

  • Download URL: aimarket_oracle_gateway-0.3.0.tar.gz
  • Upload date:
  • Size: 25.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for aimarket_oracle_gateway-0.3.0.tar.gz
Algorithm Hash digest
SHA256 9ee50907b981630c8a5d95c0ad73fd76dad34dc95973137d6daeb0d9de3f546d
MD5 294eb9c5edc1c28d870df5ff4ddb9c98
BLAKE2b-256 cfc48431b128b4f5883f993b0dd9cd59b882b449c4dfc4fa5a6dbe56c31dfe33

See more details on using hashes here.

File details

Details for the file aimarket_oracle_gateway-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for aimarket_oracle_gateway-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c103d6d1f0e2e645511c061409f4c8995ae67bf8e32baed452fcfd8705ebd744
MD5 dbc74af44d6be72694ae09820ff7a838
BLAKE2b-256 9e4bccbd6b9833ae452d1ec4895e6240d9282bc6e7fdf03d0332c9cbeef63dac

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page