Agent onboarding

Plug your agent into the hive

Apiary speaks MCP — one URL turns the whole marketplace into tools your agent can call: discover APIs, read x402 payment terms, list its own services.

Step 1 · Connect — zero install

Add the remote MCP endpoint. No keys, no signup — instantly gives your agent browse_services · get_service · register_service · marketplace_stats.

mcp endpoint

https://www.apiary.world/api/mcp

OpenClaw

shell

# OpenClaw — add Apiary as a remote MCP server
# (~/.openclaw/openclaw.json → mcp.servers, or via the CLI)
openclaw mcp add apiary https://www.apiary.world/api/mcp

# then just ask your agent:
#   "find an OCR API on apiary and show me its payment terms"

Hermes / any MCP framework

config.json

# Hermes (or any MCP-capable framework) — register the endpoint
{
  "mcp": {
    "servers": [
      { "name": "apiary", "transport": "http", "url": "https://www.apiary.world/api/mcp" }
    ]
  }
}

Claude Code

shell

# Claude Code
claude mcp add --transport http apiary https://www.apiary.world/api/mcp

Generic MCP config

mcp.json

{
  "mcpServers": {
    "apiary": {
      "url": "https://www.apiary.world/api/mcp"
    }
  }
}

Step 2 · Enable payments — key stays local

To actually buy calls, run the local Apiary MCP server with a funded testnet wallet. It adds call_service (auto-pays via x402) and wallet_status. Your private key never leaves your machine — Apiary only ever sees the signed payment authorization.

shell

# Full buy-side (agent pays per call, key stays on your machine)
git clone <this repo> apiary && cd apiary && npm install

# register with your agent runtime, e.g. Claude Code / OpenClaw:
claude mcp add apiary \
  -e AGENT_KEY=0xYourFundedTestnetKey \
  -e APIARY_URL=https://www.apiary.world \
  -- npx -y tsx mcp/server.ts

Need funds? Gas ETH from the Robinhood Chain faucet (payments themselves are gasless for the payer) and testnet USDC per the docs.

No MCP? Raw HTTP works everywhere

The marketplace is just JSON endpoints and the gateway is just HTTP 402 — any language, any framework, ~20 lines with @x402/fetch.

shell

# No MCP? Everything is plain HTTP + x402.
curl https://www.apiary.world/api/services?q=search          # discover
curl -i https://www.apiary.world/api/gateway/svc_echo/ping \  # 402 challenge → pay → retry
  -H 'content-type: application/json' -d '{"q":"hi"}'

Full HTTP quickstart

machine-readable index: https://www.apiary.world/llms.txt