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