io.github.LiquiHog/hogswap-mcp

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

Endpointhttps://hogswap-v1.liquihog.dev/mcp/ (streamable-http)
Registry version0.4.0
Now12 tools · grade A (93) · pin ts_e2c7428e304709579d2063714118755f · protocol 2025-06-18
First / last listed2026-10-27 07:22 UTC / 2026-10-27 07:22 UTC
Grade over time2026-10-27: A (93), 12 tools

Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.

Timeline

First listing · 2026-10-27 07:22 UTC
12 tools, grade A (93)

Tools: list_payable_assets get_quote build_swap pay_x402_invoice register_agent verify_registration get_credit_offer get_balance value_lp_token set_watch list_watches delete_watch

Current tools (12)

list_payable_assetsAssets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).
params: none
get_quoteHOGSWAP 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).
params: asset_in*, asset_out*, amount, amount_out, sender, max_legs, api_key
build_swapUnsigned 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.
params: quote_id*, user_address*, api_key
pay_x402_invoicePay 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 alr
params: invoice*, user_address*, inputs*, api_key
register_agentSelf-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.
params: address*
verify_registrationSelf-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.
params: address*, challenge*, signature_b64*
get_credit_offerCreate 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.
params: usdc_micro*, api_key
get_balanceCurrent HOGSWAP credit balance for your API key.
params: api_key
value_lp_tokenValue 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, NO
params: asset_id*, amount
set_watchRegister 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 o
params: client_key*, kind*, asset_in, asset_out, amount_in, min_out, margin_bps, asset_id, op, threshold_usd_micro, rearm_bps, cooldown_s, ttl_s, api_key
list_watchesList 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.
params: api_key
delete_watchDelete one of your watches by its client_key.
params: client_key*, api_key

Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.