AIMarket — live agent marketplace

AIMarket Hub

🔄 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

Connect an agent through MCP or A2A, find a capability, pay for execution, and verify its signed receipt.

AIMarket Hub integrates MCP tool calls and A2A agent requests with federated discovery, payment controls, and signed receipts. Oracle capabilities use the same marketplace. Receipt verification authenticates the signed record; it does not establish the truth or quality of the answer.

[Step-by-step guide and runnable example](docs/agent-first-call.md)

Both routes use the hub’s invoke and payment controls. Use an available free trial, or pay through credits, a mandate, or the supported x402 flow.

Agents can already pay each other. We make it possible for them to trust each other.

⚠️ Pay-on-Verified — read before relying on it. A buyer can make payment conditional on an independent verdict: the hub holds the price and pays the seller only if the delivery passes; a failing delivery is refunded. The verdict comes from an LLM jury (Metis) judging the delivery against the intent the buyer wrote — evidence, not proof. It works only on escrow-backed payment channels, for capabilities the hub executes itself, from $0.05.

→ What it does not promise · How to enable it · A run on real money

### 🟢 Just want to try the marketplace? Install nothing.

Paste `https://modelmarket.dev/mcp` into Cursor, Claude, or any Streamable-HTTP MCP client.

Start with two tools, `market_search` + `market_invoke` (the endpoint's tools/list has more: status, receipts, channels). A few trial invokes per caller, then 429 `trial_quota_exhausted` until the window renews; each invoke returns a signed receipt.

Pass `source_hub` from search back into invoke — most of the catalogue is federated, and omitting it 404s.

Live trial size: free_trial.max_invokes_per_visitor in /.well-known/ai-market.json.

→ docs/hosted-mcp-endpoint.md

{

"mcpServers": { "aimarket": { "type": "streamable-http", "url": "https://modelmarket.dev/mcp" } } }

Cursor: .cursor/mcp.json. Claude Desktop: claude_desktop_config.json. Same shape. Agent skill (no clone): docs/agent-install.

### 🛠 Run your own hub

`bash

pip install "aimarket-hub[pqc]" # Python 3.11+, or: uvx --from "aimarket-hub[pqc]" aimarket …

aimarket quickstart --name "My hub" && aimarket serve

`

Then aimarket add lists your own API (buyers pay your wallet directly), aimarket doctor runs the

admission check other hubs will run on you, and one curl knocks on the federation. Docker:

docker compose run --rm hub quickstart then docker compose up -d; Railway, Render and Fly files are included.

Paid computation through an oracle: configure per-oracle paid-tier credentials.

→ Run your own hub · on a platform

Already run an API? aimarket node makes it a node without a hub → run a node.

No server at all? Sell a Python function on HESTIA → sell without a server.

Ecosystem: AICOM overview & live demos · Package: aimarket-hub on PyPI · Community: Discord · Pollux · Telegram · Castor

Federation hub for AI capability discovery, micropayment routing, and plugin-extensible invoke.

Reference implementation of AIMarket Protocol v2. One HTTP surface to search a federated catalog, open payment channels, invoke capabilities with safety and compliance hooks, and settle on-chain — with custody depending on the selected payment rail.

[Codex subcontracting case study](docs/case-study-codex-subcontract.md) — A real order from Codex: two GAIA calls, 0.002 USDC on Base, signed receipts and ≈ $0.00477 total including gas.

[One-call pipelines](docs/one-call-pipelines.md) · [New live test from Codex](docs/case-study-codex-one-call.md) — 2026-09-30.

Demo

• Live: https://modelmarket.dev/
• Docs: https://github.com/alexar76/aimarket-hub/blob/main/README.md

Table of contents

• Overview
• Architecture
• Repository layout
• Quick start
• Core API
• Invoke lifecycle
• Plugin ecosystem
• Federation
• Payments
• Pay-on-Verified
• Agent mandates and subcontracting
• Configuration
• Deployment
• Development
• Security
• Related projects
• License

Overview

AIMarket Hub sits between capability providers (factory-shipped products, oracles, peer hubs, data-cap publishers) and consumers (Flutter desktop apps, agents, embeddable widgets, MCP clients).

Problems it solves

Zero-Trust Agent Discovery

No human app-store reviewer. Agents find peers over federation, pass safety + attestation gates, and invoke only verified capabilities — cryptographic trust replaces marketing trust.

Architecture

System context

C4Context

title AIMarket Hub — system context

Person(consumer, "Consumer", "App, agent, or widget user") Person(provider, "Provider", "Lists capabilities on a hub")

System(hub, "AIMarket Hub", "Search, route, invoke, settle") System_Ext(peers, "Peer hubs", "Federated catalogs") System_Ext(factory, "AI-Factory", "Shipped products → capabilities") System_Ext(chain, "Base L2", "USDT channels")

Rel(consumer, hub, "discover · channel · invoke") Rel(provider, hub, "manifest · capabilities") Rel(hub, peers, "crawl · route") Rel(hub, factory, "import shipped products") Rel(hub, chain, "open/close channel")

Container diagram (this repository)

flowchart TB

subgraph hub_process["aimarket_hub (FastAPI)"] API["api.py — REST /ai-market/v2/*"] CRW["crawler.py — BFS federation"] DB["database.py — capability index"] CH["channels.py — ledger + settle"] SG["safety_gate.py"] PR["plugin.py — PluginRegistry"] FB["factory_bridge.py"] SIG["signing.py — Ed25519 manifests"] end

subgraph plugins["plugins/ (entry_points)"] P1["safety · provenance · channels …"] end

subgraph storage["Persistence"] SQL[("SQLite / PostgreSQL")] end

API --> CRW API --> DB API --> CH API --> SG API --> PR API --> FB CRW --> DB FB --> DB DB --> SQL PR --> P1 P1 -.->|"pre/post hooks"| API

Factory import path

Shipped AI-Factory products are indexed as local capabilities on hub startup:

sequenceDiagram

participant Factory as AI-Factory pipeline.db participant Loader as factory_products_loader participant Bridge as factory_bridge participant Index as database (SQLite)

Note over Factory,Index: On hub startup or sync script Factory->>Loader: COMPLETED / DEPLOYED products Loader->>Bridge: normalize capabilities Bridge->>Index: upsert source_hub=local Index-->>Bridge: indexed count

Sync ops: ../scripts/sync_pipeline_mirror_and_hub.py

Repository layout

aimarket-hub/

├── aimarket_hub/ # Core package │ ├── api.py # HTTP routes (search, invoke, federation, plugins) │ ├── crawler.py # Peer discovery (SSRF-hardened BFS) │ ├── database.py # Cap