io.github.LiquiHog/hogswap-mcp

io.github.LiquiHog/hogswap-mcp · v0.4.0

Pay any Algorand x402 invoice with any asset, plus DEX swap quotes and unsigned builds.

MCPremotelocal · npmno credentialsFinanceCryptoKnowledge & docs

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 12 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 70/100

What it does: 12 tools · 6 read, 4 write (incl. delete/pay) · Crypto, Finance, Knowledge & docs

Test call list_watches: needs a key: tool error: Error executing tool list_watches: {"http_status": 401, "detail": "watches require an API key (X-API-Key header; self-is (1,016 ms)

How the rating is made

Answers without login: +30
Speed of first answer: +6
Lists tools: +10
Tool descriptions: +15
Parameter descriptions: +1
Read/write annotations: 0
Safe test call: +8
More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL

https://hogswap-v1.liquihog.dev/mcp/

Package

registry:   npm
identifier: hogswap-mcp
version:    0.4.0
transport:  stdio

Tools

12 tools listed at last check

list_payable_assets Assets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).
get_quote 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 r
build_swap 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.
pay_x402_invoice 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, sub
register_agent 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.
verify_registration 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.
get_credit_offer 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.
get_balance Current HOGSWAP credit balance for your API key.
value_lp_token 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
set_watch 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
list_watches 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.
delete_watch Delete one of your watches by its client_key.

Badge

Markdown for your README

[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.LiquiHog/hogswap-mcp.svg)](https://clawy.uk/mcp/s/io.github.LiquiHog/hogswap-mcp)

Repository