📖 Read-only mirror. aimarket-oracle-gateway is published from the canonical AI-Factory monorepo. Pull requests are not accepted — any commit pushed here is overwritten by scripts/mirror_satellites.sh on the next sync. 🐞 Found a bug or have a request? Please open an issue.

aimarket-oracle-gateway — MCP server

This repository ships a Model Context Protocol (MCP) server that exposes the AIMarket ecosystem's verifiable oracle capabilities — Platon VRF (signed randomness), Chronos VDF (verifiable delay / proof-of-elapsed-time), and LUMEN reputation — as agent-callable tools, pay-per-call over the AIMarket protocol.

Transport: stdio (mcp_stdio_server.py). Built with the official MCP Python SDK (mcp package, FastMCP). Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio servers.

A passthrough MCP server that puts the ecosystem's oracle capabilities in front of any AI agent. It is the discovery + consumption storefront for the oracle-as-a-service specs: an agent adds this server, sees the tools, and calls them — pay-per-call over the AIMarket protocol, no signup. Every result is independently verifiable (verify the signature / VDF proof rather than trusting the service).

Tools

Related MCP server: agentfolio-mcp-server

Configure (env)

If neither URL is set the server fails closed with a clear message (never silently fakes a result).

Payment safety (spec 03): the caps above are enforced client-side and a prompt-injected / runaway agent cannot override them — the gateway refuses to spend past them (fail-closed). It also rejects a hub that charges more than the advertised price. See docs/specs/03-mcp-payment-and-security.md.

Run

# stdio (local / Claude Desktop)
pip install -r requirements-mcp.txt && pip install --no-deps -e .
AIMARKET_HUB_URL=https://modelmarket.dev python mcp_stdio_server.py

# Docker
docker build -t aimarket-oracle-gateway .
docker run -i -e AIMARKET_HUB_URL=https://modelmarket.dev aimarket-oracle-gateway

Claude Desktop (mcpServers entry):

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

Publish on Glama (maintainer)

This repo ships glama.json + Dockerfile at the root. Listing: glama.ai/mcp/servers/alexar76/aimarket-oracle-gateway — claim with Login with GitHub (maintainers: alexar76). Glama builds the Docker image and indexes the tools so agents discover get_random / compute_vdf / … directly.

Verifiability (the point)

• Randomness carries an Ed25519 signature over (random_hex ‖ proof); verify against the signer key in the Hub's signed manifest. The result includes a verifiable summary (signed, has_proof).

• VDF output y=g^(2^T) mod N is checkable in one exponentiation via verify_vdf (and on-chain via ChronosVDF.sol).

Notes

• This is the storefront; the live oracles + escrow settlement already exist (see docs/onchain-journal.md).

• Shipped: platon.verify / lumen.verify / lumen.score, chronos modulus_hex, the hub's signed .well-known + /prices endpoint, and the gateway spending-cap/overcharge security core.

• Roadmap (per the specs): the full channel lifecycle (auto open/sign/settle/refund, nonce-sync, receipt-signature + TLS pinning), the remote pre-signed-voucher path, and OS-keychain key storage.

• Tests: PYTHONPATH=. pytest tests/ (routing/parse logic, no network).