alexar76/aimarket-mcp

> 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-mcp — ecosystem MCP gateway
> 🌐 **English** · Русский · Español · Français · 中文 · Glossary
> ### 🟢 Just want to try the marketplace? Install nothing.
> Paste **https://modelmarket.dev/mcp** into your MCP client and you have market_search
> + 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).
| Item | Location |
|------|----------|
| MCP entrypoint (stdio) | aimarket_mcp/stdio_server.py |
| MCP gateway (HTTP) | aimarket_mcp/server.py |
| Tool handlers + security | aimarket_mcp/tools.py, aimarket_mcp/security.py |
| Glama / Docker (stdio) | Dockerfile, glama.json |
| Self-host HTTP | Dockerfile.http, docker-compose.yml |
Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio or Streamable-HTTP.
Tools
| Tool | What it does | Hardening |
|------|--------------|-----------|
| web_fetch | Fetch a URL, return main text (readability-lite) | SSRF-guarded; output sanitized + -wrapped |
| web_search | Live DuckDuckGo search → top snippets | output sanitized + |
| metis_verify | Metis cognition + verification envelope | returns answer + verify_score / verified gate |
| market_search | Discover priced capabilities on an AIMarket hub | free; no wallet, key or channel; the hub lists only what it can execute |
| market_invoke | Run one on the hub's free trial tier | returns the signed receipt nonce; reports the hub's 402 verbatim when the allowance is spent |
Example — buy a GAIA Open-Meteo reading
Or the same HTTP the tool wraps:
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) |