Hive Swap
Cross-chain token swaps for autonomous agents on Base L2 and partner rails
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hive-swap 'https://hive-mcp-swap.onrender.com/mcp'
{
"mcpServers": {
"hive-swap": {
"type": "http",
"url": "https://hive-mcp-swap.onrender.com/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
hive-mcp-swap
Read-only Paraswap price quotes on Base.
Live contract
This MCP server exposes one swap capability:
| Surface | Purpose |
|---|---|
GET /v1/swap-route/quote | Request a live Paraswap price quote on Base |
swap_route.quote | Request the same quote through MCP |
The response identifies Paraswap as the provider and preserves the venue names present in the returned route. Hive does not construct, sign, submit, or settle a transaction. It does not collect a routing fee, operate liquidity, or custody funds.
Supported token symbols are ETH, WETH, USDC, and USDT. A caller may also supply a Base token address. The amount must be positive.
Failure behavior
If Paraswap does not return a usable quote, the HTTP endpoint returns 502 with no_route_available. The MCP tool returns a structured error payload. Unknown HTTP paths return 404. Unknown MCP tools and methods return JSON-RPC errors.
There is no execution endpoint. There is no transaction construction endpoint. There is no trust score, AML screening, or receipt-signing claim in the quote response.
Discovery
| Method | Path | Description |
|---|---|---|
GET | /health | Local liveness and declared capability |
POST | /mcp | MCP JSON-RPC 2.0, protocol 2024-11-05 |
GET | /.well-known/mcp.json | MCP discovery manifest |
GET | /.well-known/agent.json | Agent card |
GET | /.well-known/security.txt | Security contact |
GET | /llms.txt | Plain-text integration guide |
GET | /og.svg | Service image |
Example
GET https://mcp-swap.thehiveryiq.com/v1/swap-route/quote?tokenIn=ETH&tokenOut=USDC&amountIn=1
The quote is informational. A caller that chooses to trade must independently construct, review, sign, and submit a transaction using its own wallet and execution provider.
Testing
npm install
npm test
The automated suite verifies manifest parity, removal of the former execution surface, honest unknown-route behavior, and the absence of unsupported provider, fee, settlement, AML, and trust claims. A separate live probe verifies that Paraswap can return a current Base quote.
Directory
- Endpoint: https://mcp-swap.thehiveryiq.com
- Source: https://github.com/srotzin/hive-mcp-swap
Hive Civilization. Brand gold #C08D23. Steve Rotzin.
الأسئلة الشائعة
ما هو Hive Swap؟
Cross-chain token swaps for autonomous agents on Base L2 and partner rails
كيف أثبّت Hive Swap؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hive-swap 'https://hive-mcp-swap.onrender.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Hive Swap إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Hive Swap مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Hive Swap؟
ينشره srotzin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.