AIMARKET_METIS_KEY — Optional bearer token for Metis verify
AIMARKET_SEARCH_URL — DuckDuckGo HTML search endpoint override
AIMARKET_API_KEY — Optional key from https://modelmarket.dev/start: pays priced market_invoke calls from a prepaid USDC balance once the free trial is spent
Die Claude-Schaltfläche oben öffnet Claude mit ausgefülltem Namen und ausgefüllter URL. Sie bestätigen dort noch.
🔄 Synced from a monorepo — but with a live history.aimarket-mcp 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 · both welcome.
🟢 Just want to try the marketplace? Install nothing.
Paste https://modelmarket.dev/mcp into your MCP client and you have market_search
and market_invoke against the live hub, with a few free trial invokes per caller and a
signed receipt for each — no wallet, no key, no install.
→ docs/hosted-mcp-endpoint.md
Install this package when you want the other three tools (web_fetch, web_search,
metis_verify), or want to point the market tools at a hub of your own.
One MCP gateway. Five hardened tools. Shared by Metis, ARGUS, and the ecosystem.
Transport: stdio (aimarket_mcp/stdio_server.py) for Glama / Claude Desktop / Cursor, built with the
official Model Context Protocol Python SDK (mcp, FastMCP).
Also ships Streamable-HTTP on :9090 for self-hosted deployments (aimarket-mcp-http, Docker Compose).
That is the easy path (trial/sandbox). Proving an external wallet paid on-chain
is a separate escrow flow (openChannel → DebitAuthorization → hub debit/settle) —
see docs/onchain-journal.md §3l–§3m and
gaia/docs/LIVE-RELAYS.md.
Why a gateway (not per-agent tools): generic capabilities are written once; the security core lives in one audited place. Ecosystem-specific capabilities live in their own MCP servers (aimarket-oracle-gateway, aimarket-plugins).
Configure (env)
var
meaning
AIMARKET_METIS_URL
Metis verify API base (default https://metis.modelmarket.dev)
AIMARKET_METIS_KEY
optional bearer for Metis verify
AIMARKET_SEARCH_URL
DuckDuckGo HTML endpoint override
AIMARKET_HUB_URL
AIMarket hub for market_search / market_invoke (default https://modelmarket.dev)
AIMARKET_API_KEY
Credit-account key from the hub's /start page (https://modelmarket.dev/start): priced market_invoke calls are paid from its prepaid balance; while it is short the free trial still applies. In HTTP mode it pays for every caller of that server
AIMARKET_SANDBOX_VISITOR
Trial identity for market_invoke; random per install, set it to keep an allowance across reinstalls
AIMARKET_MCP_KEY
HTTP only — bearer auth key. Without one the server answers only this machine's user: a loopback packet with a loopback Host, no forwarding headers, no cross-site browser Origin, and on Linux a socket owned by the user the server runs as. That last check is what refuses a reverse proxy on the same machine whose workers run as their own user: nginx's default proxy_pass sends a loopback Host and no forwarding header. Behind any reverse proxy, set a key anyway: a proxy running as the server's own user, or any proxy on macOS or Windows, still looks local. In the HTTP Docker image (callers arrive from the bridge) every keyless call gets 401: set a key or AIMARKET_MCP_PUBLIC=1
AIMARKET_MCP_PUBLIC
HTTP only — 1 answers anonymous callers from anywhere, without a key (an explicit choice for a public endpoint)
AIMARKET_MCP_HOST
HTTP only — listen address (default 127.0.0.1; the HTTP image sets 0.0.0.0)
AIMARKET_MCP_PRODUCTION
HTTP only — 1 requires AIMARKET_MCP_KEY (fail-closed)
AIMARKET_MCP_RATE
HTTP only — requests/min per key/IP (default 120)
AIMARKET_MCP_PORT
HTTP only — listen port (default 9090)
Run (stdio — Glama / Claude Desktop)
Claude Desktop (mcpServers entry) — no clone, no working directory to get wrong:
uvx fetches the published package and runs its aimarket-mcp console script, which is
the stdio server. With the package already installed, "command": "aimarket-mcp" and no
args does the same thing.
Build, inspect, and publish a release after syncing source changes. A repository
sync alone does not refresh the deployed tool catalog or its quality evaluation.
The catalog should contain all six tools listed above.
See Glama build and release instructions.
Consumers
Connected successfully? Share your host, configuration, and one working tool using
the Show and tell template.
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Fragen
Wie installiere ich AIMarket MCP Gateway?
Kopieren Sie auf dieser Seite die http-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt AIMarket MCP Gateway einen API-Schlüssel?
Der Herausgeber nennt diese Umgebungsvariablen: AIMARKET_METIS_URL, AIMARKET_METIS_KEY, AIMARKET_SEARCH_URL, AIMARKET_API_KEY.