Hive Swap

io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 25, 2026

Cross-chain token swaps for autonomous agents on Base L2 and partner rails

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

A remote MCP server that returns read-only Paraswap price quotes for token swaps on Base, without building or executing transactions.

What you can do
Request a live Paraswap price quote for a token pair on Base, by symbol or token address, with a positive input amount. See which venues Paraswap returns in the route, alongside the provider name. Receive a structured error when no usable route is available. Nothing else: no transaction construction, signing, submission, custody, or fee collection.
When to use it
Useful when an assistant needs an indicative swap price on Base before a user or another tool decides whether and how to trade. Not suitable if you need the server to execute, sign, or settle a swap.
Requirements
A remote streamable HTTP endpoint; no package install. No authentication, environment variables, or headers are declared. The server needs outbound access to Paraswap to fetch live quotes.
Before you install
Quotes are informational only and may be unavailable; a caller that trades must build, review, sign, and submit the transaction with its own wallet. The server states it does not custody funds, collect routing fees, or provide trust scores or AML screening, so do not rely on it for those checks. Quote requests are sent to a third-party quote provider.

Installation

In SourceWeft

  1. Open Hive Swap in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-swap/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hive-swap": {
      "type": "http",
      "url": "https://hive-mcp-swap.onrender.com/mcp"
    }
  }
}

README

hive-mcp-swap

Read-only Paraswap price quotes on Base.

Live contract

This MCP server exposes one swap capability:

SurfacePurpose
GET /v1/swap-route/quoteRequest a live Paraswap price quote on Base
swap_route.quoteRequest 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

MethodPathDescription
GET/healthLocal liveness and declared capability
POST/mcpMCP JSON-RPC 2.0, protocol 2024-11-05
GET/.well-known/mcp.jsonMCP discovery manifest
GET/.well-known/agent.jsonAgent card
GET/.well-known/security.txtSecurity contact
GET/llms.txtPlain-text integration guide
GET/og.svgService 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 installnpm 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

Hive Civilization. Brand gold #C08D23. Steve Rotzin.

Source: README.md at commit 8eb9183

Tools

1

swap_route.quote

Get a read-only Paraswap price quote on Base. The response identifies the actual venues returned by Paraswap. No transaction construction, execution, custody, or fee collection.

ParameterstokenInrequiredamountInrequiredtokenOutrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts