AIMarket Oracle Gateway

Stdio MCP: 17 verifiable AIMarket oracles, 35 pay-per-call tools for AI agents.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package aimarket-oracle-gateway

Claude Code

claude mcp add aimarket-oracle-gateway -e 'AIMARKET_HUB_URL=<AIMARKET_HUB_URL>' -e 'AIMARKET_ORACLE_URL=<AIMARKET_ORACLE_URL>' -e 'AIMARKET_MAX_PER_CALL_USD=<AIMARKET_MAX_PER_CALL_USD>' -e 'AIMARKET_MAX_SPEND_USD=<AIMARKET_MAX_SPEND_USD>' -- uvx aimarket-oracle-gateway==0.3.2

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "aimarket-oracle-gateway": {
            "command": "uvx",
            "args": [
                "aimarket-oracle-gateway==0.3.2"
            ],
            "env": {
                "AIMARKET_HUB_URL": "<AIMARKET_HUB_URL>",
                "AIMARKET_ORACLE_URL": "<AIMARKET_ORACLE_URL>",
                "AIMARKET_MAX_PER_CALL_USD": "<AIMARKET_MAX_PER_CALL_USD>",
                "AIMARKET_MAX_SPEND_USD": "<AIMARKET_MAX_SPEND_USD>"
            }
        }
    }
}

Environment variables

AIMARKET_HUB_URL AIMarket Hub base URL (recommended metered path)
AIMARKET_ORACLE_URL Direct oracle-family URL (demo/free path if no hub)
AIMARKET_MAX_PER_CALL_USD Hard cap per call in USD (default 0.10)
AIMARKET_MAX_SPEND_USD Hard cumulative budget for this process (default 5.0)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

aimarket-oracle-gateway — MCP server
Tools (35)
Configure (env)
Run
Publish on Glama
Verifiability
Tests

🔄 Synced from a monorepo — but with a live history. aimarket-oracle-gateway mirrors the canonical AI-Factory monorepo. History here is append-only (no force-push). Pull requests are welcome — merged PRs are imported back into the monorepo and re-synced here, so your contribution becomes canonical. 💬 Issues · Pull requests both welcome.

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 + 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/

Frequently asked questions

What is AIMarket Oracle Gateway?

Stdio MCP: 17 verifiable AIMarket oracles, 35 pay-per-call tools for AI agents.

How do I install AIMarket Oracle Gateway?

It runs on your machine. In Claude Code: claude mcp add aimarket-oracle-gateway -e 'AIMARKET_HUB_URL=<AIMARKET_HUB_URL>' -e 'AIMARKET_ORACLE_URL=<AIMARKET_ORACLE_URL>' -e 'AIMARKET_MAX_PER_CALL_USD=<AIMARKET_MAX_PER_CALL_USD>' -e 'AIMARKET_MAX_SPEND_USD=<AIMARKET_MAX_SPEND_USD>' -- uvx aimarket-oracle-gateway==0.3.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AIMarket Oracle Gateway need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is AIMarket Oracle Gateway open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AIMarket Oracle Gateway?

It is published by alexar76. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: alexar76
Category: AI and agents
Runs: Local
GitHub stars: ★ 0
License: MIT
Language: Python
Last commit: Oct 25, 2026
Open issues: 0
Version: 0.3.2
Published: Oct 27, 2026

io.github.alexar76/aimarket-oracle-gateway

Similar servers

DFM · The Fund Management OS Launch, deposit into, rebalance and redeem onchain funds on Solana mainnet.
Replai Set up, test and publish an AI customer support Agent for your SaaS product.
Reasonbook Reasonbook: decisions that survive the session, in a local record AI agents keep.
Autodesk Inventor Parametric 3D modeling in Autodesk Inventor: sketches, features, sheet metal, assemblies
Eclipse Allowance Sealed family budget mandates + agent-uneditable fixture ledger (local/simulator); fixt...
Knot Shared memory across ChatGPT, Claude, Cursor, and Gemini. OAuth 2.1 context & supersess...
TruthSpine Every AI chat starts already knowing your project. Needs the TruthSpine app: truthspine...
Eidari A profile you control: gives your AI your role, projects and preferences, across ChatGP...

AI and agents