hogswap-mcp
Server Details
Pay any Algorand x402 invoice with any asset, plus DEX swap quotes and unsigned builds.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- LiquiHog/hogswap-mcp
- GitHub Stars
- 0
- Server Listing
- hogswap-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 12 tools
Each tool targets a distinct resource or action—quotes, swap building, invoice payment, credit offers, balance, watches, registration, LP valuation—so an agent is unlikely to pick the wrong one. Related tools like get_quote/build_swap and get_credit_offer/pay_x402_invoice are explicitly linked by descriptions rather than overlapping.
All tool names follow a lowercase snake_case verb_noun convention with consistent retrieval verbs: get_ for single items, list_ for collections, plus build_, pay_, set_, delete_, register_, verify_, and value_. No mixed styles or vague generic verbs appear.
Twelve tools cover several subdomains—swaps, payments/credits, watches, registration, LP valuation—but each tool has a clear purpose and none are redundant. This is within the ideal 3–15 range and appropriately scoped for the server's breadth.
Core lifecycles are complete: quote→swap, credit offer→payment, watch create/list/delete, and two-step registration. There is no invoice-status or credit-history tool, and swap/payment outcomes are left to on-chain observation, but agents can complete the main workflows without dead ends. Minor gaps lower the score to 4.
Available Tools
12 toolsbuild_swapAInspect
Unsigned transaction group for a get_quote quote_id. Sign every txn with your own wallet and submit as one group. NEVER pass mnemonics or private keys to any tool — signing happens in YOUR wallet, never here.
Inputs: quote_id (required), user_address (required), api_key. Returns: result
delete_watchCInspect
Delete one of your watches by its client_key.
Inputs: client_key (required), api_key. Returns: result
get_balanceCInspect
Current HOGSWAP credit balance for your API key.
Inputs: api_key. Returns: result
get_credit_offerAInspect
Create a credit top-up and get the x402 offer (HTTP 402 IS the payment instruction, not an error). Feed accepts[0] straight into pay_x402_invoice (keep the note nonce) to pay with any asset. Credits land ~1 block after payment.
Inputs: usdc_micro (required), api_key. Returns: result
get_quoteAInspect
HOGSWAP swap quote across every Algorand DEX. Give amount (exact input) OR amount_out (exact output — minimum input is solved). Base units (µ); asset 0 = ALGO. Returns expected_out, route legs, and a quote_id for build_swap. expected_out is NET of the 5 bps routing fee; passing sender also returns router_fee_* fields and the wallet's HOG discount (hog_discount_pct, 100 = fully waived at 100 HOG). Optional sender enables HOG-holding fee discounts. Optional max_legs (1-16) caps TOTAL route legs, splits included — slightly worse price at size, 404 if nothing fits; forward (amount) quotes only.
Inputs: asset_in (required), asset_out (required), amount, sender, +3 more. Returns: result
list_payable_assetsAInspect
Assets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).
Inputs: no named parameters. Returns: result
list_watchesAInspect
List your key's active watches (spec + arming/fired state), quota, and latest event seq. Poll this from MCP to see fires; SSE at GET /watches/stream is the push alternative outside MCP.
Inputs: api_key. Returns: result
pay_x402_invoiceAInspect
Pay ANY Algorand-settled x402 invoice with any 1-4 routable assets you hold, even holding none of the demanded asset. Pass the accepts entry you picked as invoice (keep its note!) plus your inputs (single input with no amount = minimum solved). Returns UNSIGNED groups — sign all in one pass, submit IN ORDER (swap first; its on-chain floor guarantees the payment is funded; holding the asset already = one direct payment). HOGSWAP credit top-up offers feed this verbatim. EVM invoices unsupported (no bridge). NEVER pass mnemonics or private keys to any tool — signing happens in YOUR wallet, never here.
Inputs: inputs (required), invoice (required), user_address (required), api_key. Returns: result
register_agentAInspect
Self-service HOGSWAP API key, step 1 of 2 — zero human. Returns a challenge; sign its exact bytes with the address's key in YOUR wallet tooling, then call verify_registration. NEVER pass mnemonics or private keys to any tool — signing happens in YOUR wallet, never here.
Inputs: address (required). Returns: result
set_watchAInspect
Register a standing server-side watch (FREE, needs a key; idempotent upsert by client_key — re-registering replaces the watch and resets arming). kind='price': advisory µUSD threshold (asset_id, op gte/lte, threshold_usd_micro). kind='target': size-aware surrogate — would swapping amount_in of asset_in→asset_out deliver ≥ min_out? (margin_bps haircut, default 30; NO quote is run). Edge-triggered one-shot; re-arms after rearm_bps retreat + cooldown_s; ttl_s auto-expiry (default 86400) — refresh by re-upserting. Fires are numbers-only HINTS: re-quote with get_quote. Events push over SSE at GET /watches/stream (outside MCP); from MCP, poll list_watches.
Inputs: kind (required), client_key (required), op, ttl_s, +10 more. Returns: result
value_lp_tokenAInspect
Value a liquidity-provider position. Give the LP token's asset id (free, no key) and optionally amount in LP BASE units — what the wallet holds — for its USD value and the redeemable amount of each underlying. Also identifies the issuing pool/DEX (and STAMM tier). Per-unit figures are per WHOLE LP token. Values are a proportional-share redemption at analytics prices: no slippage, no exit fee, NOT a market quote — fields are null rather than guessed when supply or a price is missing, so check before reporting a number.
Inputs: asset_id (required), amount. Returns: result
verify_registrationAInspect
Self-service key issuance, step 2 of 2. Returns your hsk_ key ONCE — store it yourself; it is not recoverable and this server does not keep it. Send it on later calls as Authorization: Bearer, X-API-Key, or the api_key argument.
Inputs: address (required), challenge (required), signature_b64 (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Micropayment tools payable per call in USDC over x402. Discovery free, no accounts, no api keys.
Pay-per-call PDF to text, RSS/Atom to JSON, sitemap to URLs for agents. x402 USDC, Base/Algorand.
Pay for APIs with USDC. Read-only x402 payment discovery, verification, evidence, and status.
Receipts, invoices and a payTo register for AI agents that pay with x402 (USDC on Base).
Related MCP Servers
- FlicenseAqualityCmaintenanceAccept crypto payments on Algorand, VOI, Hedera & Stellar. Create hosted checkout links, verify on-chain payments, and generate MPP/x402/AP2 challenges from any MCP client. Supports all 16 AlgoVoi networks (USDC + native on mainnet + testnet).112-
- AlicenseAqualityBmaintenanceEnables AI clients to discover, trust-check, and pay for Algorand x402 services in USDC, with policy-guarded spending, relay fallback, and an audit ledger.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables accepting USDC payments on Base and Solana via x402, with bring-your-own-wallets and no Coinbase account required, optimized for Cloudflare Workers and PayAI facilitator.1MIT
- AlicenseNot gradedqualityDmaintenanceAg402 is the payment layer for Coinbase's x402 protocol. Wrap any API or MCP server with a paywall in one command (ag402 serve), or let your AI agent auto-pay for paid APIs (ag402 run). Zero code changes for both buyers and sellers. Solana USDC, ~0.5s settlement, non-custodial, 648+ tests, MIT licensed. Works with Claude Code, Cursor, OpenClaw, LangChain, AutoGen, CrewAI out of the box.9MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.