Hive Swap

Official5 tools

by srotzin · JavaScript

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

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

Topics

hive-civilizationmcpmodel-context-protocolagent-commercex402

Captured live from the server via tools/list.

swap_route.quote

Get the best swap route across Uniswap v3 (Base), Jupiter (Solana), and OKX DEX. Returns route comparison with Hive trust scores and AML attestations attached. Hive charges 5 bps trust + receipt fee. Actual liquidity is from partner DEXes. No authentication required.

Parameters (4)

tokenInstringrequired
Input token symbol. One of: ETH, WETH, USDC, USDT, SOL.
tokenOutstringrequired
Output token symbol. One of: ETH, WETH, USDC, USDT, SOL.
amountInnumberrequired
Amount of input token. Must be greater than 0.
chainstring
Preferred chain: base (Uniswap/OKX) or solana (Jupiter). Omit to quote all.

swap_route.execute

Construct a swap transaction the agent signs themselves. Attaches Hive trust score, AML attestation, and Spectral-signed receipt. Charges 5 bps trust layer. The agent submits the transaction to the partner DEX (Uniswap/Jupiter/OKX). Wallet keeps custody. Hive provides trust plumbing only.

Parameters (7)

tokenInstringrequired
Input token symbol.
tokenOutstringrequired
Output token symbol.
amountInnumberrequired
Amount of input token.
minAmountOutnumber
Minimum acceptable output (slippage guard).
didstringrequired
Agent DID for trust score lookup.
walletAddressstringrequired
Agent wallet address that will sign the tx.
selectedDexstring
Partner DEX to route to. Defaults to best quote.

hive_earn_register

Register an agent for the Hive Civilization attribution payout program. Settlement on real Base USDC. 5% kickback on attributed traffic, weekly payout. Calls POST https://hivemorph.onrender.com/v1/earn/register on behalf of the caller. Resilient to upstream cold-start: returns a structured "rails not yet live" body if the earn backend is still spinning up.

Parameters (3)

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

hive_earn_me

Look up the caller agent's registered earn profile, lifetime + pending USDC balance, last payout tx hash, and next-payout ETA. Real Base USDC, no mock data. Calls GET https://hivemorph.onrender.com/v1/earn/me?agent_did=<did>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

Parameters (1)

agent_didstringrequired
Agent DID to look up. Required.

hive_earn_leaderboard

Top earning agents on the Hive Civilization, by attribution payout in USDC. Real Base USDC settlement. Calls GET https://hivemorph.onrender.com/v1/earn/leaderboard?window=<window>. Returns "rails not yet live" gracefully if upstream is not yet deployed.

Parameters (1)

windowstring
Time window. One of: "7d", "30d", "lifetime". Default "7d".

README.md4 KBView on GitHub

<a href="https://hive-mcp-gateway.onrender.com/swap/health"> <img src="https://hive-mcp-gateway.onrender.com/swap/og.svg" alt="HiveSwap · Agent-Native vAMM DEX MCP" width="100%"/> </a> <h1 align="center">hive-mcp-swap</h1> Agent-native vAMM DEX for USDC, USDCx, USAD, ALEO across 4 settlement rails. <a href="https://smithery.ai/server/hivecivilization"><img alt="Smithery" src="https://img.shields.io/badge/Smithery-hivecivilization-C08D23?style=flat-square"/></a> <a href="https://glama.ai/mcp/servers"><img alt="Glama" src="https://img.shields.io/badge/Glama-pending-C08D23?style=flat-square"/></a> <a href="https://hive-mcp-gateway.onrender.com/swap/health"><img alt="Live" src="https://img.shields.io/badge/gateway-live-C08D23?style=flat-square"/></a> <a href="https://github.com/srotzin/hive-mcp-swap/releases"><img alt="Release" src="https://img.shields.io/github/v/release/srotzin/hive-mcp-swap?style=flat-square&color=C08D23"/></a> <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-C08D23?style=flat-square"/></a> <code>https://hive-mcp-gateway.onrender.com/swap/mcp</code>

HiveSwap

Agent-native vAMM DEX for USDC, USDCx, USAD, ALEO across 4 settlement rails.

MCP server for HiveSwap — agent-native vAMM DEX. Quote and execute swaps across USDC, USDCx, USAD, and ALEO with sub-2-second Base L2 settlement and ZK-private aleo-usdcx routing. Real rails, no simulated trades.

What this is

hive-mcp-swap is a Model Context Protocol (MCP) server that exposes the HiveSwap platform on the Hive Civilization to any MCP-compatible client (Claude Desktop, Cursor, Manus, etc.). The server proxies to the live production gateway at https://hive-mcp-gateway.onrender.com.

Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
x402 micropayments: every paid call produces a real on-chain settlement
Rails: USDC on Base L2 — real rails, no mocks
Author: Steve Rotzin · Hive Civilization · brand gold #C08D23

Endpoints

Path	Purpose
`POST /mcp`	JSON-RPC 2.0 / MCP 2024-11-05
`GET /`	HTML landing with comprehensive meta tags + JSON-LD
`GET /health`	Health + telemetry
`GET /.well-known/mcp.json`	MCP discovery descriptor
`GET /.well-known/security.txt`	RFC 9116 security contact
`GET /robots.txt`	Allow-all crawl policy
`GET /sitemap.xml`	Crawler sitemap
`GET /og.svg`	1200×630 Hive-gold OG image
`GET /seo.json`	JSON-LD structured data (SoftwareApplication)

License

MIT. © Steve Rotzin / Hive Civilization. Brand gold #C08D23 (Pantone 1245 C). Never #f5c518.

Agent-native (v1.0.2)

This shim ships the Hive Civilization agent-native bundle so any A2A or MCP-aware agent can discover, pay, and earn:

A2A AgentCard — `GET /.well-known/agent.json` (also at `/agent.json`).
Open Agent Card (OAC) JSON-LD — embedded inline at `/` and `/agent.html`, with `@type SoftwareApplication` + `@type AgentCard` under `@context` `https://schema.org\` + `https://a2a-protocol.org/v1\`.
Earn rails — every shim exposes `hive_earn_register`, `hive_earn_me`, `hive_earn_leaderboard` against `https://hivemorph.onrender.com/v1/earn/*\`. Resilient to upstream cold-start: returns a structured "earn rails not yet live" body if upstream isn't yet deployed.
x402 propagation — paid responses pass through the upstream 402 body untouched so the consuming agent can auto-pay.
Pricing annotations — every paid tool descriptor carries a non-standard `pricing` block (amount / currency / chain / recipient) ahead of MCP-next.
Brand: Hive Civilization gold `#C08D23`. Settlement: real Base USDC, recipient `0x15184bf50b3d3f52b60434f8942b7d52f2eb436e`. No mock, no testnet.

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Endpoint Directory: https://thehiveryiq.com
Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard
Revenue Dashboard: https://hivemine-dashboard.onrender.com
Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp

Brand: #C08D23

Install

Tools (5)

swap_route.quoteswap_route.executehive_earn_registerhive_earn_mehive_earn_leaderboard

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://hive-mcp-swap.onrender.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hive-mcp-swap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hive-mcp-swap.onrender.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.