protogrid

Search / io.github.LiquiHog/hogswap-mcp

hogswap-mcp

R0· no sign-in

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

v0.4.0 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality80good
Trust90of 100
Uptime, 30 days96%
Latency p50433 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "hogswap-mcp": {
      "type": "http",
      "url": "https://hogswap-v1.liquihog.dev/mcp/"
    }
  }
}
claude mcp add --transport http hogswap-mcp https://hogswap-v1.liquihog.dev/mcp/
[mcp_servers.hogswap-mcp]
url = "https://hogswap-v1.liquihog.dev/mcp/"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hogswap-mcp": {
      "type": "remote",
      "url": "https://hogswap-v1.liquihog.dev/mcp/",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "hogswap-mcp": {
      "type": "http",
      "url": "https://hogswap-v1.liquihog.dev/mcp/"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hogswap-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vaG9nc3dhcC12MS5saXF1aWhvZy5kZXYvbWNwLyJ9"
}
{
  "servers": {
    "hogswap-mcp": {
      "type": "http",
      "url": "https://hogswap-v1.liquihog.dev/mcp/"
    }
  }
}
{
  "mcpServers": {
    "hogswap-mcp": {
      "httpUrl": "https://hogswap-v1.liquihog.dev/mcp/"
    }
  }
}
extensions:
  "hogswap-mcp":
    enabled: true
    name: "hogswap-mcp"
    type: streamable_http
    uri: "https://hogswap-v1.liquihog.dev/mcp/"
    timeout: 300

Quality 80 / 100good

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: pay_x402_invoice (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); verify_registration (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); value_lp_token (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 2,025 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependencies67 · weight 15
  • pass
    deps.known_vulnsno known advisory in 98 resolved packages
  • fail
    deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
  • pass
    deps.resolvable[email protected] resolved: 98 packages

12 tools, about 2,025 tokens to load them all · tool set 9e3cf42815f6 · checked 2026-10-20 17:02 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance80
liveness98
freshness85
hygiene100

+repository +namespace-matches-repo +reachable +uptime-96% ~updated-70d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm97 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19

advisoryseveritypackagefixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP serverhigh@modelcontextprotocol/[email protected]MCP SDK, directfixed in 1.31.0

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://hogswap-v1.liquihog.dev/mcp/ streamable-httpnoneyes96%433 ms2026-07-282026-10-20
packageregistryversionruntimesecrets
hogswap-mcpnpm0.4.0–HOGSWAP_API_KEY

Tools (12)

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.
delete_watchDelete one of your watches by its client_key.
get_balanceCurrent HOGSWAP credit balance for your API key.
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.
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). 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.
list_payable_assetsAssets accepted as payment inputs for pay_x402_invoice and credit top-ups (price-confidence gated; ALGO and USDC always included).
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.
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 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.
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.
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 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.
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, NOT a market quote — fields are null rather than guessed when supply or a price is missing, so check before reporting a number.
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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.LiquiHog/hogswap-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://hogswap-v1.liquihog.dev/mcp/",
      "type": "streamable-http"
    }
  ],
  "version": "0.4.0",
  "packages": [
    {
      "version": "0.4.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "hogswap-mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "HOGSWAP_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "hsk_ HOGSWAP API key for the paid tier (self-issue with the register_agent/verify_registration tools). Free tools work without it."
        },
        {
          "name": "HOGSWAP_API_URL",
          "format": "string",
          "description": "API base URL (default https://hogswap-v1.liquihog.dev)."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/LiquiHog/hogswap-mcp",
    "source": "github"
  },
  "description": "Pay any Algorand x402 invoice with any asset, plus DEX swap quotes and unsigned builds."
}