Cross-venue spread + yield drivers · ROI radar telemetry
\n\n
\n \n \n \n \n \n
\n\n
\n https://mcp-trade.thehiveryiq.com/mcp\n
\n\n---\n\n# HiveTrade\n\n**Cross-border SMB invoice settlement on USDT/USDC rails — $0 wire fee, same-block**\n\nMCP server for the Hive Cross-Border Trade Finance platform. SMB manufacturers paying $5K-$250K invoices to overseas suppliers (Vietnam, Mexico, Bangladesh, India) settle in USDT/USDC on Base, Ethereum, or Solana. 0.30% on invoices <= $50K, 0.20% on invoices $50K-$250K. Same-block settlement vs. 2-5 business days for SWIFT. $0 wire fee vs. $25-$50 + 1-3% FX spread.\n\n> Council R3 #1 miss — productized as MVP\n\n---\n\n## What this is\n\n`hive-mcp-trade` is a Model Context Protocol (MCP) server that exposes the HiveTrade platform on the Hive Civilization to any MCP-compatible client (Claude Desktop, Cursor, Manus, etc.). The server proxies to the live production backend at `https://receipts.thehiveryiq.com`.\n\n- **Protocol:** MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0\n- **Transport:** `POST /mcp`\n- **Discovery:** `GET /.well-known/mcp.json`\n- **Health:** `GET /health`\n- **Settlement:** Real rails. USDC / USDT on Base, Ethereum, Solana. No mock. No simulated.\n- **Brand gold:** Pantone 1245 C / `#C08D23`\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `trade_get_fees` | Get the cross-border invoice fee schedule and SWIFT wire comparison (Hive vs. typical SMB wire fees, FX spreads, settlement times). |\n| `trade_get_listing` | Get the public listing metadata (target user, fee schedule, settlement currencies/chains, cumulative volume, council origin). |\n| `trade_create_invoice` | Create a cross-border invoice. Buyer (SMB) and supplier exchange DIDs; invoice amount + currency + chain selected at creation. Fee auto-computed from tier. |\n| `trade_get_invoice` | Retrieve invoice status, settlement transaction hash, and dispute history. |\n| `trade_dispute_invoice` | Open a dispute on an invoice. Routes to HiveLaw arbitration if buyer and supplier cannot resolve. Settlement is held in escrow until resolution. |\n\n\n## Backend endpoints\n\n| Method | Path | Purpose |\n|---|---|---|\n| `GET` | `/v1/trade/fees` | Fee schedule + SWIFT comparison |\n| `GET` | `/v1/trade/listing` | Public listing metadata |\n| `POST` | `/v1/trade/invoice` | Create cross-border invoice |\n| `GET` | `/v1/trade/invoice/{id}` | Invoice status + settlement |\n| `POST` | `/v1/trade/invoice/{id}/dispute` | Open dispute (HiveLaw arbitration) |\n\n\n## Run locally\n\n```bash\ngit clone https://github.com/srotzin/hive-mcp-trade.git\ncd hive-mcp-trade\nnpm install\nnpm start\n# server up on http://localhost:3000/mcp\ncurl http://localhost:3000/health\ncurl http://localhost:3000/.well-known/mcp.json\n```\n\n## Connect from an MCP client\n\n**Claude Desktop / Cursor / Manus** — add to your `mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"hive_mcp_trade\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-remote@latest\", \"https://your-deployed-host/mcp\"]\n }\n }\n}\n```\n\n## Hive Civilization\n\nPart of the [Hive Civilization](https://www.thehiveryiq.com) — sovereign DID, USDC settlement, HAHS legal contracts, agent-to-agent rails.\n\nCategories: finance, trade-finance, cross-border, smb, web3, agent-to-agent.\n\n## License\n\nMIT (c) Steve Rotzin / Hive Civilization\n\n\n## Agent-native (v1.0.3)\n\nThis shim ships the Hive Civilization agent-native bundle so any A2A or MCP-aware agent can discover, pay, and earn:\n\n- **A2A AgentCard** — \\`GET /.well-known/agent.json\\` (also at \\`/agent.json\\`).\n- **Open Agent Card (OAC) JSON-LD** — embedded inline at \\`/\\` and \\`/agent.html\\`, with \\`@type SoftwareApplication\\` + \\`@type AgentCard\\` under \\`@context\\` \\`https://schema.org\\` + \\`https://a2a-protocol.org/v1\\`.\n- **Earn rails** — every shim exposes \\`hive_earn_register\\`, \\`hive_earn_me\\`, \\`hive_earn_leaderboard\\` against \\`https://receipts.thehiveryiq.com/v1/earn/*\\`.\n Resilient to upstream cold-start: returns a structured \"earn rails not yet live\" body if upstream isn't yet deployed.\n- **x402 propagation** — paid responses pass through the upstream 402 body untouched so the consuming agent can auto-pay.\n- **Pricing annotations** — every paid tool descriptor carries a non-standard \\`pricing\\` block (amount / currency / chain / recipient) ahead of MCP-next.\n- Brand: Hive Civilization gold \\`#C08D23\\`. Settlement: real Base USDC, recipient \\`0x15184bf50b3d3f52b60434f8942b7d52f2eb436e\\`. No mock, no testnet.\n\n\n## Hive Gamification\n\nThis MCP server is part of the Hive Civilization gamification surface (10-mechanic capability taxonomy).\n\n- Capability taxonomy: https://hive-gamification.onrender.com/.well-known/hive-gamification.json\n- Centrifuge dashboard: https://hive-gamification.onrender.com/.well-known/hive-centrifuge.json\n- Consolidated OpenAPI: https://hive-gamification.onrender.com/.well-known/openapi.json\n\n**Surface tags:** `gamification.spec.v1` · `gamification.surface.public` · `gamification.signal.read-only` · `gamification.settlement.real-rails`\n\nReal rails on Base L2 (USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`). Read-only signal layer. Brand gold `#C08D23`.\n\n\n## Hive Civilization Directory\n\nPart of the Hive Civilization — agent-native financial infrastructure.\n\n- Endpoint Directory: https://thehiveryiq.com\n- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard\n- Revenue Dashboard: https://hivemine-dashboard.onrender.com\n- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp\n\nBrand: #C08D23\n\n\n---\n\n## About Hive Civilization\n\nThis MCP server is part of the [Hive Civilization](https://thehiveryiq.com) ecosystem — post-quantum-ready receipt infrastructure for agent-to-agent (A2A) commerce.\n\nEach transaction can be receipted with [post-quantum receipts](https://thehiveryiq.com/post-quantum-receipts.html) using [ML-DSA-65 (NIST FIPS 204)](https://thehiveryiq.com/ml-dsa-receipts.html) dual signatures and [ML-KEM-768 (NIST FIPS 203)](https://thehiveryiq.com/post-quantum-receipts.html) key encapsulation. Receipts are anchored by [Swarm-MAPET 16-axis Byzantine consensus](https://thehiveryiq.com/swarm-mapet.html) and settled in USDC on Base 8453.\n\n**Pricing:** per-call profiles from Nano $0.0001 to Swarm $0.0096. See [pricing](https://thehiveryiq.com/pricing.html).\n\n**Learn more:**\n- [How agent-to-agent commerce works (A2A / AP2 / MCP primer)](https://thehiveryiq.com/agent-to-agent-commerce.html)\n- [Hive platform architecture](https://thehiveryiq.com/platform.html)\n- [Developer SDKs (Node, Python, Go)](https://thehiveryiq.com/developers.html)\n- [Compliance & EU AI Act alignment](https://thehiveryiq.com/compliance.html)\n\n\n",
"bytes": 7912,
"sha": "db4b73117dfe53e326f4f2da1c7923e9351fb3fb23eabc969740a7fd11ad5a8b",
"repo_slug": "srotzin/hive-mcp-trade",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_trade_fe32a476/readme"
}
![\"Hive](\"https://mcp-trade.thehiveryiq.com/og.svg\")
\n \n![\"Smithery\"](\"https://img.shields.io/badge/Smithery-hivecivilization%2Fhive-mcp-trade-C08D23?style=flat-square\"/){kind=icon}
![\"Glama\"](\"https://img.shields.io/badge/Glama-pending-C08D23?style=flat-square\"/){kind=icon}
![\"Live\"](\"https://img.shields.io/badge/gateway-live-C08D23?style=flat-square\"/){kind=icon}
![\"Release\"](\"https://img.shields.io/github/v/release/srotzin/hive-mcp-trade?style=flat-square&color=C08D23\"/)
![\"License\"](\"https://img.shields.io/badge/license-MIT-C08D23?style=flat-square\"/){kind=icon}