Hogswap MCP server
online · 100% uptimeio.github.LiquiHog/hogswap-mcp·v0.4.0Pay any Algorand x402 invoice with any asset, plus DEX swap quotes and unsigned builds.
0 stars107 downloads/wk
Reviews
Write oneNobody has reviewed Hogswap yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Hogswap tools (12, 3 write)
write = sends, deletes, buys or postsbuild_swapFreeUnsigned 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.
delete_watchwrite actionFreeDelete one of your watches by its client_key.
get_balanceFreeCurrent HOGSWAP credit balance for your API key.
get_credit_offerwrite actionFreeCreate 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.
get_quoteFreeHOGSWAP 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.
list_payable_assetsFreeAssets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).
list_watchesFreeList 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.
pay_x402_invoicewrite actionFreePay 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.
register_agentFreeSelf-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.
set_watchFreeRegister 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.
value_lp_tokenFreeValue 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.
verify_registrationFreeSelf-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.
Public scan report
scanner v0.1.10 · 2026-11-04 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- Live reliabilityremote reachable in 1420ms20/20
- Tool poisoning12 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 3 write-action tools with no auth3/15
- Maintenancelast push 85 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How Hogswap compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 75% of 1,761 Finance servers
- Tools
- 12
- the typical Finance server has 8
- Tools that change things
- 25%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Finance server answers 100%
- Response time
- 372 ms
- faster than 40% of 1,133 Finance servers
- Downloads a week
- 107
- more than 70% of 421 Finance servers with a package
What its tools let an agent do: 7 read · 1 create · 3 change · 1 delete
Install Hogswap in Claude Code, Cursor or VS Code
claude mcp add --transport http hogswap-mcp https://hogswap-v1.liquihog.dev/mcp/
What the publisher says
From the Hogswap repository's README, as published. We do not edit it. Read it on GitHub
hogswap-mcp
MCP server exposing HOGSWAP to AI agents: DEX-aggregated quotes, unsigned swap builds, zero-human API-key self-registration, and the star — payx402invoice: pay any Algorand-settled x402 invoice with any 1–4 assets you hold, via an exact-out router swap. API reference: hogswap-v1.liquihog.dev/reference. Building an app rather than an agent? Official SDKs: hogswap-js-sdk (npm) and hogswap-py-sdk (PyPI).
Strictly non-custodial: every transaction-producing tool returns unsigned groups; you sign with your own wallet tooling and submit yourself. Never give any tool a mnemonic or private key.
Run (stdio)
npm install
HOGSWAP_API_KEY=hsk_... node src/index.mjs # key optionalClaude Code: claude mcp add hogswap -e HOGSWAPAPIKEY=hsk_... -- node /src/index.mjs
Tools
Free (no key): listpayableassets, getquote, registeragent, verifyregistration. getquote takes optional max_legs (1–16) to cap total route legs, splits included — for replaying the route under your own resource budget.
🔑 Require a HOGSWAP API key (set HOGSWAPAPIKEY, or self-issue one with registeragent → sign → verifyregistration): buildswap, payx402invoice, getcreditoffer, getbalance, plus the watch tools setwatch / listwatches / delete_watch (standing server-side price/target alerts — free of charge, but namespaced by key). Without a key these return an auth error, not a build.
Watch fires are numbers-only hints — re-quote with getquote when one fires. From MCP, poll listwatches; outside MCP the server pushes events over SSE at GET /watches/stream.
payx402invoice returns two groups (swap, then payment) — sign all txns in one pass, submit the groups in order; the swap's on-chain floor guarantees the payment is funded. A HOGSWAP credit top-up's 402 offer is itself an x402 invoice: feed its accepts[0] (with the note nonce) straight into payx402invoice to buy credits with any asset.
Remote (no local process)
The same 12 tools are served over MCP Streamable HTTP at https://hogswap-v1.liquihog.dev/mcp/ — hosted by the HOGSWAP API itself, no local process needed. Use the trailing slash — the bare /mcp 307-redirects to /mcp/, costing an extra round trip per call. Point any remote-capable MCP client at it; pass your key as Authorization: Bearer hsk... (the Claude API connector's authorizationtoken does exactly this).
Smoke tests
HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke.mjs # stdio
HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke-remote.mjs # remoteBoth default to the live API; set HOGSWAPAPIURL (stdio) or MCP_URL (remote) to point them at another instance. Read-only + build-only; nothing is signed or broadcast.
Nothing above is checked by us. What we check is on the safety report.
Hogswap: common questions
- Is Hogswap MCP server safe?
- Mostly: it is graded B (83/100). Read the Hogswap safety report
- How do I install Hogswap?
- It runs remotely at hogswap-v1.liquihog.dev. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Hogswap need an API key?
- Yes. The registry entry asks for
HOGSWAP_API_KEY. - Is Hogswap maintained?
- The last commit was 85 days ago (2026-08-11). The latest release is v0.4.0.
- Is Hogswap up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Hogswap?
- Servers from other publishers that do the same job: Blockrun MCP server, three.ws Tutor MCP server and Agent402.Tools: pay-per-call web tools MCP server. Compare all Hogswap alternatives.
- How does Hogswap compare with other Finance MCP servers?
- safety score 83/100 (higher than 75% of 1,761 Finance servers); tools 12 (the typical Finance server has 8); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Hogswap
Same job from other publishers: the closest match first, then the best rated.
- BlockrunWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.not reviewedEstablishedB
- three.ws TutorRead a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.not reviewedEstablishedA
- Agent402.Tools: pay-per-call web toolsAgentic Finance: 500+ agent tools, multi-chain USDC over x402 or MPP, or free via proof-of-worknot reviewedEstablishedA
- XeroXero MCP server for invoices, contacts, payments, quotes, and financial reports.not reviewedGrowingA
- Tapetide - Indian Stock Market MCP48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, optionsnot reviewedEstablishedA