English Français العربية

io.github.LiquiHog/hogswap-mcp

Registre officiel Finance et paiements

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hogswap-mcp 'https://hogswap-v1.liquihog.dev/mcp/'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hogswap-mcp": {
            "type": "http",
            "url": "https://hogswap-v1.liquihog.dev/mcp/"
        }
    }
}
NPM package hogswap-mcp
Claude Code 
claude mcp add hogswap-mcp -e 'HOGSWAP_API_KEY=<your hogswap_api_key>' -e 'HOGSWAP_API_URL=<HOGSWAP_API_URL>' -- npx -y hogswap-mcp@0.4.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hogswap-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "hogswap-mcp@0.4.0"
            ],
            "env": {
                "HOGSWAP_API_KEY": "<your hogswap_api_key>",
                "HOGSWAP_API_URL": "<HOGSWAP_API_URL>"
            }
        }
    }
}

Variables d'environnement

  • HOGSWAP_API_KEY secret hsk_ HOGSWAP API key for the paid tier (self-issue with the register_agent/verify_registration tools). Free tools work without it.
  • HOGSWAP_API_URL API base URL (default https://hogswap-v1.liquihog.dev).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. hogswap-mcp
  2. Run (stdio)
  3. Tools
  4. Remote (no local process)
  5. Smoke tests

hogswap-mcp

MCP server exposing HOGSWAP to AI agents: DEX-aggregated quotes, unsigned swap builds, zero-human API-key self-registration, and the star — pay_x402_invoice: pay any Algorand-settled x402 invoice with any 1–4 assets you hold, via an exact-out router swap. API reference: hogswap-v1.liquihog.dev/reference. Building an app rather than an agent? Official SDKs: hogswap-js-sdk (npm) and hogswap-py-sdk (PyPI).

Strictly non-custodial: every transaction-producing tool returns unsigned groups; you sign with your own wallet tooling and submit yourself. Never give any tool a mnemonic or private key.

Run (stdio)

npm install
HOGSWAP_API_KEY=hsk_... node src/index.mjs        # key optional

Claude Code: claude mcp add hogswap -e HOGSWAP_API_KEY=hsk_... -- node <abs-path>/src/index.mjs

EnvMeaning
HOGSWAP_API_URLAPI base (default https://hogswap-v1.liquihog.dev)
HOGSWAP_API_KEYhsk_ bearer key; self-issue via the register_agent / verify_registration tools

Tools

Free (no key): list_payable_assets, get_quote, register_agent, verify_registration. get_quote takes optional max_legs (1–16) to cap total route legs, splits included — for replaying the route under your own resource budget.

🔑 Require a HOGSWAP API key (set HOGSWAP_API_KEY, or self-issue one with register_agent → sign → verify_registration): build_swap, pay_x402_invoice, get_credit_offer, get_balance, plus the watch tools set_watch / list_watches / delete_watch (standing server-side price/target alerts — free of charge, but namespaced by key). Without a key these return an auth error, not a build.

Watch fires are numbers-only hints — re-quote with get_quote when one fires. From MCP, poll list_watches; outside MCP the server pushes events over SSE at GET /watches/stream.

pay_x402_invoice returns two groups (swap, then payment) — sign all txns in one pass, submit the groups in order; the swap's on-chain floor guarantees the payment is funded. A HOGSWAP credit top-up's 402 offer is itself an x402 invoice: feed its accepts[0] (with the note nonce) straight into pay_x402_invoice to buy credits with any asset.

Remote (no local process)

The same 12 tools are served over MCP Streamable HTTP at https://hogswap-v1.liquihog.dev/mcp/ — hosted by the HOGSWAP API itself, no local process needed. Use the trailing slash — the bare /mcp 307-redirects to /mcp/, costing an extra round trip per call. Point any remote-capable MCP client at it; pass your key as Authorization: Bearer hsk_... (the Claude API connector's authorization_token does exactly this).

Smoke tests

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke.mjs        # stdio

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke-remote.mjs # remote

Both default to the live API; set HOGSWAP_API_URL (stdio) or MCP_URL (remote) to point them at another instance. Read-only + build-only; nothing is signed or broadcast.

Questions fréquentes

Qu'est-ce que io.github.LiquiHog/hogswap-mcp ?

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

Comment installer io.github.LiquiHog/hogswap-mcp ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hogswap-mcp 'https://hogswap-v1.liquihog.dev/mcp/'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.LiquiHog/hogswap-mcp ?

Oui. Il attend HOGSWAP_API_KEY, à renseigner dans sa configuration.

io.github.LiquiHog/hogswap-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.LiquiHog/hogswap-mcp ?

Il est publié par LiquiHog. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.