Skip to main content
Glama

Server Details

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

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A3.9/5.0

Scored across 12 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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 tools
build_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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI clients to discover, trust-check, and pay for Algorand x402 services in USDC, with policy-guarded spending, relay fallback, and an audit ledger.
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Ag402 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.
      9
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.