AIMarket MCP Gateway

io.github.alexar76Published by GitHub account alexar76v0.6.4Updated Oct 29, 2026

Stdio + HTTP MCP gateway: SSRF-hardened web_fetch, web_search, metis_verify, market_search.

The publisher's own server: Domain availability and quotes (demo)

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & CommerceAI & ML

Overview

AI-generated overview

MCP gateway exposing hardened web fetch, DuckDuckGo search, Metis verification, and AIMarket marketplace search/invoke tools over stdio or HTTP.

What you can do
  • Fetch a URL and return its main text, with SSRF guards and output wrapped as untrusted
  • Run live DuckDuckGo web searches and get top snippets
  • Send a query to Metis for a cognition answer plus a verification score and gate
  • Search an AIMarket hub for priced capabilities and invoke one on the free trial tier, returning a signed receipt
  • Check remaining trial invokes and prepaid balance
When to use it
Useful when an assistant needs web reading and search plus a way to discover and call priced capabilities on an AIMarket hub, all behind one shared security layer. The hosted endpoint covers only the market tools; install this package for web_fetch, web_search and metis_verify or to point the market tools at your own hub.
Requirements
Runs as a local stdio process (uvx aimarket-mcp or pip install aimarket-mcp) or as a self-hosted Streamable-HTTP server on port 9090. Optional settings include AIMARKET_API_KEY for prepaid paid calls, AIMARKET_METIS_KEY and AIMARKET_METIS_URL for verification, AIMARKET_SEARCH_URL, AIMARKET_HUB_URL, and AIMARKET_MCP_KEY for HTTP bearer auth. Network access is needed for fetching, search and hub calls.
Before you install
market_invoke can spend money: priced calls are charged to the prepaid USDC balance behind AIMARKET_API_KEY once the free trial is used, and in HTTP mode that key pays for every caller of the server. Fetched and searched content is passed to the assistant as untrusted text. HTTP deployments are refused without AIMARKET_MCP_KEY unless explicitly made public; the local relay and unverified options weaken that protection. AIMARKET_METIS_KEY is a bearer token sent to the Metis service.

Installation

In SourceWeft

  1. Open AIMarket MCP Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Follow the launch instructions in the repository.

README

aimarket-mcp — ecosystem MCP gateway

[CI] [aimarket-mcp MCP server] [MCP gateway] [stdio + HTTP] [14 tests passing] [Test coverage] [License: MIT]

🔄 Synced from the AI-Factory monorepo (append-only history). Pull requests are welcome — merged PRs are imported back and re-synced here. Issues · Pull requests

🌐 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 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. Six 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).

ItemLocation
MCP entrypoint (stdio)aimarket_mcp/stdio_server.py
MCP gateway (HTTP)aimarket_mcp/server.py
Tool handlers + securityaimarket_mcp/tools.py, aimarket_mcp/security.py
Glama / Docker (stdio)Dockerfile, glama.json
Self-host HTTPDockerfile.http, docker-compose.yml

Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio or Streamable-HTTP.

Tools

ToolWhat it doesHardening
web_fetchFetch a URL, return main text (readability-lite)SSRF-guarded; output sanitized + <untrusted>-wrapped
web_searchLive DuckDuckGo search → top snippetsoutput sanitized + <untrusted>
metis_verifyMetis cognition + verification envelopereturns answer + verify_score / verified gate
market_searchDiscover priced capabilities on an AIMarket hubfree; no wallet, key or channel; the hub lists only what it can execute
market_invokeRun one on the hub's free trial tierreturns the signed receipt nonce; reports the hub's 402 verbatim when the allowance is spent
market_statusShow the free trial invokes and prepaid balance leftread-only; the hub's health, this installation's remaining trial in the current window, and the AIMARKET_API_KEY balance when set (never the key)

Example — buy a GAIA Open-Meteo reading

text
market_search(intent="gaia weather open-meteo")market_invoke(  capability_id="gaia.weather.read@v1",  product_id="gaia.gateway",  source_hub="https://iot.modelmarket.dev",  # input JSON with device_id om-wx-01 — see tool schema / hub docs)

Or the same HTTP the tool wraps:

bash
curl -s -X POST "${AIMARKET_HUB_URL:-https://modelmarket.dev}/ai-market/v2/invoke" \  -H 'Content-Type: application/json' \  -H 'X-AIMarket-Sandbox-Visitor: vis_mcp_om_wx' \  -d '{"capability_id":"gaia.weather.read@v1","product_id":"gaia.gateway",       "source_hub":"https://iot.modelmarket.dev","input":{"device_id":"om-wx-01"}}'

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)

varmeaning
AIMARKET_METIS_URLMetis verify API base (default https://metis.modelmarket.dev)
AIMARKET_METIS_KEYoptional bearer for Metis verify
AIMARKET_SEARCH_URLDuckDuckGo HTML endpoint override
AIMARKET_HUB_URLAIMarket hub for market_search / market_invoke (default https://modelmarket.dev)
AIMARKET_API_KEYCredit-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_VISITORTrial identity for market_invoke; random per install, set it to keep an allowance across reinstalls
AIMARKET_MCP_KEYHTTP bearer auth key. HTTP requests without a key are refused by default, including direct loopback clients. Configure a key and send Authorization: Bearer <key>; stdio needs no HTTP key. An intentionally anonymous endpoint can instead set AIMARKET_MCP_PUBLIC=1
AIMARKET_MCP_LOCAL_RELAYHTTP only — default off. 1 explicitly trusts tokenless local TCP callers including arbitrary proxies/tunnels running as the server's user. Requires a loopback peer and Host, local browser Origin, no forwarding headers and verified same-user socket ownership. Prefer a bearer key; process names and public listeners cannot prove that a request is direct
AIMARKET_MCP_LOCAL_UNVERIFIEDHTTP only — default off. On macOS/Windows or another host without Linux socket tables, 1 additionally bypasses unavailable socket ownership proof. Requires AIMARKET_MCP_LOCAL_RELAY=1 as well. Neither setting bypasses a configured bearer key or production mode
AIMARKET_MCP_PUBLICHTTP only — 1 answers anonymous callers from anywhere, without a key (an explicit choice for a public endpoint)
AIMARKET_MCP_HOSTHTTP only — listen address (default 127.0.0.1; the HTTP image sets 0.0.0.0)
AIMARKET_MCP_PRODUCTIONHTTP only — 1 requires AIMARKET_MCP_KEY (fail-closed)
AIMARKET_MCP_RATEHTTP only — requests/min per key/IP (default 120)
AIMARKET_MCP_PORTHTTP only — listen port (default 9090)

Run (stdio — Glama / Claude Desktop)

Claude Desktop (mcpServers entry) — no clone, no working directory to get wrong:

json
{  "mcpServers": {    "aimarket-mcp": {      "command": "uvx",      "args": ["aimarket-mcp"]    }  }}

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.

From a checkout, for development:

bash
pip install -e .python -m aimarket_mcp.stdio_server

Run (HTTP — self-host)

bash
pip install -e .AIMARKET_MCP_KEY=sk-... AIMARKET_MCP_PRODUCTION=1 aimarket-mcp-http   # :9090# or: docker compose up -d   (uses Dockerfile.http)

Cursor / Claude (Streamable HTTP)

json
{  "mcpServers": {    "aimarket-web": {      "type": "streamable-http",      "url": "http://127.0.0.1:9090/mcp",      "headers": {        "Authorization": "Bearer YOUR_AIMARKET_MCP_KEY"      }    }  }}

Publish on Glama

Listing: aimarket-mcp. Glama generates a container from the build settings in its admin panel:

FieldValue
Build steps["bash scripts/glama_install.sh"]
CMD arguments["mcp-proxy", "--", ".venv/bin/python", "-m", "aimarket_mcp.stdio_server"]
Placeholder parameters{}
Pinned commit SHAempty (latest synced commit)

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.
  • Metis — enable the preset:
    yaml
    enable_mcp_tools: truemcp_ecosystem_presets: [aimarket-web]
  • ARGUS — add the server to argus.config.json mcpServers (see that repo).

Test

bash
pip install -e '.[dev]' && pytest -q

Registries

See the directory submission checklist and current status before submitting or refreshing a listing.

RegistryListing
Glamaglama.ai/mcp/servers/alexar76/aimarket-mcp
Official MCP Registryio.github.alexar76/aimarket-mcp — server.json + GitHub Actions
PyPIpip install aimarket-mcp
GitHub Releasesgithub.com/alexar76/aimarket-mcp/releases

Source: README.md at commit e9504c8

Tools

0
SourceWeft has not read this server's tools yet.

Version history

3
  1. v0.6.4LatestOct 29, 2026
  2. v0.4.0Oct 7, 2026
  3. v0.3.0Sep 16, 2026

Score

60% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Modelmarket integrations