hive-mcp-swap

Read-only Paraswap price quotes on Base.

Live contract

This MCP server exposes one swap capability:

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

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.