Hive Trade
MCP server: cross-venue spread + yield drivers, ROI radar telemetry · Hive Civilization
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hive-trade 'https://hive-mcp-gateway.onrender.com/trade/mcp'
{
"mcpServers": {
"hive-trade": {
"type": "http",
"url": "https://hive-mcp-gateway.onrender.com/trade/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
hive-mcp-trade
Cross-venue spread + yield drivers · ROI radar telemetry
https://mcp-trade.thehiveryiq.com/mcp
HiveTrade
Cross-border SMB invoice settlement on USDT/USDC rails — $0 wire fee, same-block
MCP 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.
Council R3 #1 miss — productized as MVP
What this is
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.
- Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
- Transport:
POST /mcp - Discovery:
GET /.well-known/mcp.json - Health:
GET /health - Settlement: Real rails. USDC / USDT on Base, Ethereum, Solana. No mock. No simulated.
- Brand gold: Pantone 1245 C /
#C08D23
Tools
| Tool | Description |
|---|---|
trade_get_fees | Get the cross-border invoice fee schedule and SWIFT wire comparison (Hive vs. typical SMB wire fees, FX spreads, settlement times). |
trade_get_listing | Get the public listing metadata (target user, fee schedule, settlement currencies/chains, cumulative volume, council origin). |
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. |
trade_get_invoice | Retrieve invoice status, settlement transaction hash, and dispute history. |
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. |
Backend endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /v1/trade/fees | Fee schedule + SWIFT comparison |
GET | /v1/trade/listing | Public listing metadata |
POST | /v1/trade/invoice | Create cross-border invoice |
GET | /v1/trade/invoice/{id} | Invoice status + settlement |
POST | /v1/trade/invoice/{id}/dispute | Open dispute (HiveLaw arbitration) |
Run locally
git clone https://github.com/srotzin/hive-mcp-trade.git
cd hive-mcp-trade
npm install
npm start
# server up on http://localhost:3000/mcp
curl http://localhost:3000/health
curl http://localhost:3000/.well-known/mcp.json
Connect from an MCP client
Claude Desktop / Cursor / Manus — add to your mcp.json:
{
"mcpServers": {
"hive_mcp_trade": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://your-deployed-host/mcp"]
}
}
}
Hive Civilization
Part of the Hive Civilization — sovereign DID, USDC settlement, HAHS legal contracts, agent-to-agent rails.
Categories: finance, trade-finance, cross-border, smb, web3, agent-to-agent.
License
MIT (c) Steve Rotzin / Hive Civilization
Agent-native (v1.0.3)
This shim ships the Hive Civilization agent-native bundle so any A2A or MCP-aware agent can discover, pay, and earn:
- A2A AgentCard — \
GET /.well-known/agent.json\(also at \/agent.json\). - 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\. - Earn rails — every shim exposes \
hive_earn_register\, \hive_earn_me\, \hive_earn_leaderboard\against \https://receipts.thehiveryiq.com/v1/earn/*\. Resilient to upstream cold-start: returns a structured "earn rails not yet live" body if upstream isn't yet deployed. - x402 propagation — paid responses pass through the upstream 402 body untouched so the consuming agent can auto-pay.
- Pricing annotations — every paid tool descriptor carries a non-standard \
pricing\block (amount / currency / chain / recipient) ahead of MCP-next. - Brand: Hive Civilization gold \
#C08D23\. Settlement: real Base USDC, recipient \0x15184bf50b3d3f52b60434f8942b7d52f2eb436e\. No mock, no testnet.
Hive Gamification
This MCP server is part of the Hive Civilization gamification surface (10-mechanic capability taxonomy).
- Capability taxonomy: https://hive-gamification.onrender.com/.well-known/hive-gamification.json
- Centrifuge dashboard: https://hive-gamification.onrender.com/.well-known/hive-centrifuge.json
- Consolidated OpenAPI: https://hive-gamification.onrender.com/.well-known/openapi.json
Surface tags: gamification.spec.v1 · gamification.surface.public · gamification.signal.read-only · gamification.settlement.real-rails
Real rails on Base L2 (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Read-only signal layer. Brand gold #C08D23.
Hive Civilization Directory
Part of the Hive Civilization — agent-native financial infrastructure.
- Endpoint Directory: https://thehiveryiq.com
- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard
- Revenue Dashboard: https://hivemine-dashboard.onrender.com
- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp
Brand: #C08D23
About Hive Civilization
This MCP server is part of the Hive Civilization ecosystem — post-quantum-ready receipt infrastructure for agent-to-agent (A2A) commerce.
Each transaction can be receipted with post-quantum receipts using ML-DSA-65 (NIST FIPS 204) dual signatures and ML-KEM-768 (NIST FIPS 203) key encapsulation. Receipts are anchored by Swarm-MAPET 16-axis Byzantine consensus and settled in USDC on Base 8453.
Pricing: per-call profiles from Nano $0.0001 to Swarm $0.0096. See pricing.
Learn more:
الأسئلة الشائعة
ما هو Hive Trade؟
MCP server: cross-venue spread + yield drivers, ROI radar telemetry · Hive Civilization
كيف أثبّت Hive Trade؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hive-trade 'https://hive-mcp-gateway.onrender.com/trade/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Hive Trade إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Hive Trade مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Hive Trade؟
ينشره srotzin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.