hive-mcp-swap (io.github.srotzin/hive-mcp-swap)

This MCP server provides read-only cross-chain token swap price quotes for autonomous agents on Base L2 and partner rails. It exposes a single swap-related capability that returns live Paraswap quote data without constructing, signing, submitting, or settling transactions. Tooling is limited to quote retrieval and route identification.

🛠️ Key Features

Uses Paraswap as the quote provider
Endpoint: GET /v1/swap-route/quote for live Paraswap price quotes on Base
MCP operation: swap_route.quote for the same quote via MCP
Preserves venue names present in the returned route
Supported token symbols: ETH, WETH, USDC, USDT

🚀 Use Cases

Retrieve live swap-route quotes on Base for agent decision-making
Compare or reference Paraswap venue names from returned route data

⚡ Developer Benefits

Single-purpose MCP tool for consistent quote access
Read-only behavior: no transaction lifecycle handling
Aligns quote responses with Paraswap provider identification

⚠️ Limitations

No transaction construction, signing, submission, or settlement
Does not collect routing fees
Does not operate liquidity or custody funds

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

text

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

bash

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.

tokenIn	string	required	Input token symbol. One of: ETH, WETH, USDC, USDT, SOL.
tokenOut	string	required	Output token symbol. One of: ETH, WETH, USDC, USDT, SOL.
amountIn	number	required	Amount of input token. Must be greater than 0.
chain	string	optional	Preferred chain: base (Uniswap/OKX) or solana (Jupiter). Omit to quote all.

tokenIn	string	required	Input token symbol.
tokenOut	string	required	Output token symbol.
amountIn	number	required	Amount of input token.
minAmountOut	number	optional	Minimum acceptable output (slippage guard).
did	string	required	Agent DID for trust score lookup.
walletAddress	string	required	Agent wallet address that will sign the tx.
selectedDex	string	optional	Partner DEX to route to. Defaults to best quote.

agent_did	string	required	Caller agent DID (e.g. did:hive:0x… or did:web:…). Required.
payout_address	string	required	Base L2 EVM address (0x…) to receive USDC kickback payouts.
attribution_url	string	required	Public URL of the agent / page driving attributed traffic to Hive. Used for ranking + audit.

Hive Swap

hive-mcp-swap (io.github.srotzin/hive-mcp-swap)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

swap_route.quote

swap_route.execute

hive_earn_register

hive_earn_me

hive_earn_leaderboard

hive-mcp-swap

Live contract

Failure behavior

Discovery

Example

Testing

Directory

Install

Remote endpoint

Related servers