Aimarket Oracle Gateway logo

Aimarket Oracle Gateway

by alexar76

MCP gateway for paid, verifiable oracle operations including randomness, routing, reputation, and risk analysis.

Install Aimarket Oracle Gateway

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "alexar76-aimarket-oracle-gateway": {
      "command": "uvx",
      "args": [
        "aimarket-oracle-gateway"
      ],
      "env": {
        "AIMARKET_HUB_URL": "YOUR_VALUE_HERE",
        "AIMARKET_ORACLE_URL": "YOUR_VALUE_HERE",
        "AIMARKET_PAYMENT_CHANNEL": "YOUR_VALUE_HERE",
        "AIMARKET_PAYMENT_CHANNEL_SECRET": "YOUR_VALUE_HERE",
        "AIMARKET_API_TOKEN": "YOUR_VALUE_HERE",
        "AIMARKET_MAX_PER_CALL_USD": "YOUR_VALUE_HERE",
        "AIMARKET_MAX_SPEND_USD": "YOUR_VALUE_HERE",
        "AIMARKET_PRICE_TOLERANCE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx aimarket-oracle-gateway

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 20d ago.

Overview

alexar76/aimarket-oracle-gateway MCP server exposes oracle computations through a Python MCP server over stdio. It routes requests to the AIMarket Hub or a direct oracle URL, with optional payment channels, bearer authentication, spending caps, and price checks. Results are designed for independent verification using signatures, proofs, certificates, or deterministic replay. Reach for it when an agent needs externally computed oracle results rather than local-only tool execution.

Use cases

  • Request verifiable random values for agent workflows
  • Check reputation scores and trust data
  • Compute and verify least-time routes
  • Audit compute costs with reproducible evidence
  • Analyze cascade risk under a spending limit

Key features

  • 35 oracle tools over MCP stdio
  • AIMarket Hub and direct oracle routing
  • Per-call pricing and optional usage bundles
  • Client-side call and cumulative spending caps
  • Independent result verification
  • Capability discovery without a call charge

Tools5

What Aimarket Oracle Gateway lets your agent do. Expand a tool for its parameters.

Self-reported~38 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

10/10 checks healthy over the last 86d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · aimarket-oracle-gateway (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit6d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed5Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Aimarket Oracle Gateway works

What alexar76/aimarket-oracle-gateway MCP server does

The alexar76/aimarket-oracle-gateway MCP server provides an MCP storefront for oracle-as-a-service capabilities. It exposes 35 tools covering randomness, verifiable delay functions, reputation, consensus, compute-cost auditing, routing, cascade analysis, sampling, optimization, resilience, time-locks, topology, transport, and spectral analysis. A free discovery tool, list_oracle_capabilities, reports the available capability identifiers and advertised pricing.

The gateway is intended for agents that need results with an evidence trail. Depending on the oracle family, outputs can include cryptographic signatures, VDF proofs, classical certificates, or data that can be replayed deterministically. Verification tools are available for several operations, including random values, VDFs, reputation, compute cost, routes, cascade risk, network resilience, Sortes draws, Gauss results, time-locks, transport, and Fourier results.

How it works

The server runs as a stdio MCP process built with the official Python MCP SDK and FastMCP. Tool requests are routed through the gateway core to either the configured AIMarket Hub or a direct oracle-family endpoint. The Hub path supports metered, paid calls; the direct endpoint is described as a demo or free path.

Individual tools have published per-call prices. Bundles are packaging on the Hub rather than a replacement for the default pay-per-call model.

Verification is specific to each oracle family. Examples include Ed25519 signatures for Platon randomness, Wesolowski proofs for Chronos, deterministic re-aggregation for Murmuration, and replayable certificates for routing and risk calculations.

Setup and configuration

Running alexar76/aimarket-oracle-gateway MCP server requires installing the requirements and the local project, then starting aimarket_oracle_gateway.stdio_server with Python. The documented example uses AIMARKET_HUB_URL=https://modelmarket.dev.

Set AIMARKET_HUB_URL for the recommended metered route, or set AIMARKET_ORACLE_URL to use a direct oracle-family endpoint. The server fails closed if neither URL is configured. Optional settings include a payment-channel identifier, its debit secret, and an AIMARKET_API_TOKEN bearer token.

Spending controls include AIMARKET_MAX_PER_CALL_USD, AIMARKET_MAX_SPEND_USD, and AIMARKET_PRICE_TOLERANCE. The documented defaults are $0.10 per call, $5.00 cumulatively, and 0.10 for advertised-price tolerance.

Tools and capabilities

Representative tools include:

  • get_random, get_randomness_beacon, ask_oracle, and verify_random for randomness operations.
  • compute_vdf and verify_vdf for delay computations and proof checking.
  • get_reputation_scores, get_agent_trust, and verify_reputation for LUMEN-related scoring.
  • aggregate_values, audit_compute_cost, and compute_least_time_route for aggregation, cost analysis, and routing.
  • analyze_cascade_risk and its verification counterpart for cascade analysis.
  • Sampling, optimization, resilience, time-lock, topology, transport, and spectral tools.

Limitations and notes

The alexar76/aimarket-oracle-gateway MCP server is a read-only mirror of a canonical monorepo, so changes should be directed to the upstream project rather than this repository. Calls may incur per-request charges through the Hub, and optional bundles are also paid. A configured URL is mandatory, while authentication and payment-channel settings depend on the selected deployment path.

The server supports Claude Desktop, Cursor, Glama, and other MCP clients that can run stdio servers.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Aimarket Oracle Gateway

It does not provide a single package-manager install command.

Yes. The server runs over stdio, and the README includes a Claude Desktop configuration using `python -m aimarket_oracle_gateway.stdio_server`.

Set either `AIMARKET_HUB_URL` or `AIMARKET_ORACLE_URL`; the server fails closed when neither is present.

The gateway uses pay-per-call pricing by default, with tool prices listed in the README. Optional Hub bundles are available for selected high-volume tools, and a direct oracle URL is described as a demo or free path.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAimarket Oracle Gateway AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/alexar76-aimarket-oracle-gateway?style=directory)](https://allmcps.com/mcp/alexar76-aimarket-oracle-gateway)
HTML Embed
<a href="https://allmcps.com/mcp/alexar76-aimarket-oracle-gateway"><img src="https://allmcps.com/api/badge/alexar76-aimarket-oracle-gateway?style=directory" alt="Aimarket Oracle Gateway on AllMCPs" /></a>