io.github.LiquiHog/hogswap-mcp

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 tooling, never on this server.

Delete one of your watches by its client_key.

Current HOGSWAP credit balance for your API key.

Create a credit top-up and get the x402 offer (HTTP 402 IS the payment instruction, not an error). accepts[0] is a plain USDC transfer invoice — feed it straight into pay_x402_invoice (keep the note!) to pay with any asset. Credits land ~1 block after the payment confirms.

HOGSWAP swap quote across every Algorand DEX. Give amount (exact input) OR amount_out (exact output — minimum input is solved). Amounts are 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. Pass `sender` and the response also carries router_fee_* fields plus the wallet's HOG discount (hog_discount_pct, 100 = fee fully waived at 100 HOG), so you can tell the user what the trade cost and what it saved.

Assets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included). Asset metadata is on get_quote responses or GET /assets.

List your key's active watches (spec + arming/fired state), quota, and the latest event seq. Poll this from MCP to see fires; SSE at GET /watches/stream is the push alternative outside MCP.

Pay ANY Algorand-settled x402 invoice with any 1-4 routable assets you hold, even if you hold none of the demanded asset. Pass the `accepts` entry you picked from the 402 response as `invoice`, plus your inputs (single input with no amount = minimum is solved for you). Returns UNSIGNED groups — sign everything in one pass, then submit the groups IN ORDER (swap first; its on-chain floor guarantees the payment is funded; if you already hold the demanded asset it is a single direct payment). Works for HOGSWAP credit top-up offers too: feed accepts[0] of the 402 straight in. EVM-settled invoices are not supported (no bridge). NEVER pass mnemonics or private keys to any tool — signing happens in YOUR wallet tooling, never on this server.

Self-service HOGSWAP API key, step 1 of 2 — zero human, zero email. Returns a challenge string; sign its exact bytes with the Algorand address's key IN YOUR OWN wallet tooling, then call verify_registration. NEVER pass mnemonics or private keys to any tool — signing happens in YOUR wallet tooling, never on this server.

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 on an asset. kind='target': size-aware surrogate — "would swapping amount_in of asset_in→asset_out deliver ≥ min_out?" (estimated with a margin_bps haircut; NO quote is run). Edge-triggered one-shot; re-arms after a rearm_bps retreat + cooldown_s. TTL auto-expires — refresh by re-upserting. Fired events are numbers-only HINTS: re-quote with get_quote when one fires. Events push over SSE at GET /watches/stream (outside MCP); from MCP, poll list_watches.

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 actually holds — to get its USD value and the redeemable amount of each underlying asset. Also identifies which pool/DEX (and STAMM tier) issued the token. 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 come back null rather than guessed when supply or a price is missing, so check before reporting a number. Errors if the asset is not a known LP token.

Self-service key issuance, step 2 of 2. Returns your hsk_ API key ONCE — store it yourself (e.g. set HOGSWAP_API_KEY); it is not recoverable and this server does not keep it.