aimarket-oracle-gateway — MCP server
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+gapcertificate - 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ee50907b981630c8a5d95c0ad73fd76dad34dc95973137d6daeb0d9de3f546d
|
|
| MD5 |
294eb9c5edc1c28d870df5ff4ddb9c98
|
|
| BLAKE2b-256 |
cfc48431b128b4f5883f993b0dd9cd59b882b449c4dfc4fa5a6dbe56c31dfe33
|
File details
Details for the file aimarket_oracle_gateway-0.3.0-py3-none-any.whl.
File metadata
- Download URL: aimarket_oracle_gateway-0.3.0-py3-none-any.whl
- Upload date:
- Size: 22.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c103d6d1f0e2e645511c061409f4c8995ae67bf8e32baed452fcfd8705ebd744
|
|
| MD5 |
dbc74af44d6be72694ae09820ff7a838
|
|
| BLAKE2b-256 |
9e4bccbd6b9833ae452d1ec4895e6240d9282bc6e7fdf03d0332c9cbeef63dac
|