Servers Playground How we check Add a server Log in

Hogswap Mcp

Working · 2.1 s

io.github.LiquiHog/hogswap-mcpv0.4.0

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

Crypto & Web3

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

quote_idstring, required

user_addressstring, required

api_keystring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Hogswap Mcp MCP server | mcptry

Tools (12)

build_swap

Argument	Type	Description
api_key	any
quote_id*	string
user_address*	string

Input schema (JSON)

{
  "type": "object",
  "title": "build_swapArguments",
  "required": [
    "quote_id",
    "user_address"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "quote_id": {
      "type": "string",
      "title": "Quote Id"
    },
    "user_address": {
      "type": "string",
      "title": "User Address"
    }
  }
}

delete_watch

Delete one of your watches by its client_key.

Argument	Type	Description
api_key	any
client_key*	string

Input schema (JSON)

{
  "type": "object",
  "title": "delete_watchArguments",
  "required": [
    "client_key"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "client_key": {
      "type": "string",
      "title": "Client Key"
    }
  }
}

get_balance

Current HOGSWAP credit balance for your API key.

Argument	Type	Description
api_key	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_balanceArguments",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    }
  }
}

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.

Argument	Type	Description
api_key	any
usdc_micro*	integer

Input schema (JSON)

{
  "type": "object",
  "title": "get_credit_offerArguments",
  "required": [
    "usdc_micro"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "usdc_micro": {
      "type": "integer",
      "title": "Usdc Micro"
    }
  }
}

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 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.

Argument	Type	Description
amount	any
sender	any
api_key	any
asset_in*	integer
max_legs	any
asset_out*	integer
amount_out	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_quoteArguments",
  "required": [
    "asset_in",
    "asset_out"
  ],
  "properties": {
    "amount": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Amount",
      "default": null
    },
    "sender": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sender",
      "default": null
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "asset_in": {
      "type": "integer",
      "title": "Asset In"
    },
    "max_legs": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Legs",
      "default": null
    },
    "asset_out": {
      "type": "integer",
      "title": "Asset Out"
    },
    "amount_out": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Amount Out",
      "default": null
    }
  }
}

list_payable_assets

Assets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).

No arguments.

Input schema (JSON)

{
  "type": "object",
  "title": "list_payable_assetsArguments",
  "properties": {}
}

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.

Argument	Type	Description
api_key	any

Input schema (JSON)

{
  "type": "object",
  "title": "list_watchesArguments",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    }
  }
}

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, 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.

Argument	Type	Description
inputs*	array
api_key	any
invoice*	object
user_address*	string

Input schema (JSON)

{
  "type": "object",
  "title": "pay_x402_invoiceArguments",
  "required": [
    "invoice",
    "user_address",
    "inputs"
  ],
  "properties": {
    "inputs": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "title": "Inputs"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "invoice": {
      "type": "object",
      "title": "Invoice",
      "additionalProperties": true
    },
    "user_address": {
      "type": "string",
      "title": "User Address"
    }
  }
}

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.

Argument	Type	Description
address*	string

Input schema (JSON)

{
  "type": "object",
  "title": "register_agentArguments",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "title": "Address"
    }
  }
}

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_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.

Argument	Type	Description
op	any
kind*	string
ttl_s	any
api_key	any
min_out	any
asset_id	any
asset_in	any
amount_in	any
asset_out	any

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 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.

Argument	Type	Description
amount	any
asset_id*	integer

Input schema (JSON)

{
  "type": "object",
  "title": "value_lp_tokenArguments",
  "required": [
    "asset_id"
  ],
  "properties": {
    "amount": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Amount",
      "default": null
    },
    "asset_id": {
      "type": "integer",
      "title": "Asset Id"
    }
  }
}

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.

Argument	Type	Description
address*	string
challenge*	string
signature_b64*	string

Input schema (JSON)

{
  "type": "object",
  "title": "verify_registrationArguments",
  "required": [
    "address",
    "challenge",
    "signature_b64"
  ],
  "properties": {
    "address": {
      "type": "string",
      "title": "Address"
    },
    "challenge": {
      "type": "string",
      "title": "Challenge"
    },
    "signature_b64": {
      "type": "string",
      "title": "Signature B64"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "title": "set_watchArguments",
  "required": [
    "client_key",
    "kind"
  ],
  "properties": {
    "op": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Op",
      "default": null
    },
    "kind": {
      "type": "string",
      "title": "Kind"
    },
    "ttl_s": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ttl S",
      "default": null
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "min_out": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Out",
      "default": null
    },
    "asset_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset Id",
      "default": null
    },
    "asset_in": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset In",
      "default": null
    },
    "amount_in": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Amount In",
      "default": null
    },
    "asset_out": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset Out",
      "default": null
    },
    "rearm_bps": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rearm Bps",
      "default": null
    },
    "client_key": {
      "type": "string",
      "title": "Client Key"
    },
    "cooldown_s": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cooldown S",
      "default": null
    },
    "margin_bps": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Margin Bps",
      "default": null
    },
    "threshold_usd_micro": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Threshold Usd Micro",
      "default": null
    }
  }
}