{
  "markdown": "# hive-mcp-swap\n\nRead-only Paraswap price quotes on Base.\n\n## Live contract\n\nThis MCP server exposes one swap capability:\n\n| Surface | Purpose |\n|---|---|\n| `GET /v1/swap-route/quote` | Request a live Paraswap price quote on Base |\n| `swap_route.quote` | Request the same quote through MCP |\n\nThe 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.\n\nSupported token symbols are ETH, WETH, USDC, and USDT. A caller may also supply a Base token address. The amount must be positive.\n\n## Failure behavior\n\nIf 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.\n\nThere 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.\n\n## Discovery\n\n| Method | Path | Description |\n|---|---|---|\n| `GET` | `/health` | Local liveness and declared capability |\n| `POST` | `/mcp` | MCP JSON-RPC 2.0, protocol `2024-11-05` |\n| `GET` | `/.well-known/mcp.json` | MCP discovery manifest |\n| `GET` | `/.well-known/agent.json` | Agent card |\n| `GET` | `/.well-known/security.txt` | Security contact |\n| `GET` | `/llms.txt` | Plain-text integration guide |\n| `GET` | `/og.svg` | Service image |\n\n## Example\n\n```text\nGET https://mcp-swap.thehiveryiq.com/v1/swap-route/quote?tokenIn=ETH&tokenOut=USDC&amountIn=1\n```\n\nThe 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.\n\n## Testing\n\n```bash\nnpm install\nnpm test\n```\n\nThe 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.\n\n## Directory\n\n- Endpoint: https://mcp-swap.thehiveryiq.com\n- Source: https://github.com/srotzin/hive-mcp-swap\n\nHive Civilization. Brand gold `#C08D23`. Steve Rotzin.\n",
  "bytes": 2330,
  "sha": "d8284ed86d4ccd0c5a6c629ec9794a4439800a2c74d37d8a9b657e488689ab7a",
  "repo_slug": "srotzin/hive-mcp-swap",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_swap_3661db4b/readme"
}