# io.github.LiquiHog/hogswap-mcp (remote · hogswap-v1.liquihog.dev)

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

- Trust score: 59/100 (low)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-17

## Components

- remote · `hogswap-v1.liquihog.dev`: 59/100 (this document), [markdown](https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1.md), [page](https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1)
- npm · `hogswap-mcp`: 71/100, [markdown](https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-mcp.md), [page](https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-mcp)

## Channel facts

- Endpoint: `https://hogswap-v1.liquihog.dev/mcp/`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.4.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-17.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 12 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS enforcement could not be verified: the plaintext port answered with HTTP 406, which proves neither a plaintext path nor enforcement.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1359 tokens (~113/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http liquihog-hogswap-mcp https://hogswap-v1.liquihog.dev/mcp/
```

### Codex

```toml
[mcp_servers.liquihog-hogswap-mcp]
url = "https://hogswap-v1.liquihog.dev/mcp/"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "liquihog-hogswap-mcp": {
      "type": "remote",
      "url": "https://hogswap-v1.liquihog.dev/mcp/",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add liquihog-hogswap-mcp --url https://hogswap-v1.liquihog.dev/mcp/ --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  liquihog-hogswap-mcp:
    url: "https://hogswap-v1.liquihog.dev/mcp/"
```

### Other

```json
{
  "mcpServers": {
    "liquihog-hogswap-mcp": {
      "type": "http",
      "url": "https://hogswap-v1.liquihog.dev/mcp/"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-16 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-14 (score 58, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-12 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-11 (score 56, +1)

- [security] Tool “get_quote” rewrote its description, which is the text the model reads
- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server
- [functional] Server version: 0.3.0 → 0.4.0

### 2026-08-10 (score 55, +1)

- [functional regression] Schema quality: pass → fail
- [functional] Server version: 0.2.0 → 0.3.0
- [functional] New tool “value_lp_token”

### 2026-08-09 (score 54, 0)

- [security] Tool “get_quote” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 96 → 107
- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 0.1.0 → 0.2.0
- [functional] New tool “set_watch”
- [functional] New tool “delete_watch”
- [functional] New tool “list_watches”
- [cosmetic] “get_quote” added an optional parameter “max_legs”

### 2026-08-08 (score 54)

First indexed and scored.

## MCP tools (12)

### `list_payable_assets` (~37 tokens)

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

Output parameters:

- `result` (string)

### `get_quote` (~202 tokens)

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.

Input parameters:

- `amount`
- `amount_out`
- `api_key`
- `asset_in` (integer, required)
- `asset_out` (integer, required)
- `max_legs`
- `sender`

Output parameters:

- `result` (string)

### `build_swap` (~75 tokens)

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.

Input parameters:

- `api_key`
- `quote_id` (string, required)
- `user_address` (string, required)

Output parameters:

- `result` (string)

### `pay_x402_invoice` (~179 tokens)

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.

Input parameters:

- `api_key`
- `inputs` (array, required)
- `invoice` (object, required)
- `user_address` (string, required)

Output parameters:

- `result` (string)

### `register_agent` (~78 tokens)

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.

Input parameters:

- `address` (string, required)

Output parameters:

- `result` (string)

### `verify_registration` (~91 tokens)

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.

Input parameters:

- `address` (string, required)
- `challenge` (string, required)
- `signature_b64` (string, required)

Output parameters:

- `result` (string)

### `get_credit_offer` (~79 tokens)

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.

Input parameters:

- `api_key`
- `usdc_micro` (integer, required)

Output parameters:

- `result` (string)

### `get_balance` (~26 tokens)

Current HOGSWAP credit balance for your API key.

Input parameters:

- `api_key`

Output parameters:

- `result` (string)

### `value_lp_token` (~137 tokens)

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.

Input parameters:

- `amount`
- `asset_id` (integer, required)

Output parameters:

- `result` (string)

### `set_watch` (~268 tokens)

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.

Input parameters:

- `amount_in`
- `api_key`
- `asset_id`
- `asset_in`
- `asset_out`
- `client_key` (string, required)
- `cooldown_s`
- `kind` (string, required)
- `margin_bps`
- `min_out`
- `op`
- `rearm_bps`
- `threshold_usd_micro`
- `ttl_s`

Output parameters:

- `result` (string)

### `list_watches` (~60 tokens)

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.

Input parameters:

- `api_key`

Output parameters:

- `result` (string)

### `delete_watch` (~32 tokens)

Delete one of your watches by its client_key.

Input parameters:

- `api_key`
- `client_key` (string, required)

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1#diagnostics

## Score history

- 2026-08-17: 59
- 2026-08-16: 59
- 2026-08-15: 58
- 2026-08-14: 58
- 2026-08-13: 57
- 2026-08-12: 57
- 2026-08-11: 56
- 2026-08-10: 55
- 2026-08-09: 54
- 2026-08-08: 54

## Links

- Remote endpoint: https://hogswap-v1.liquihog.dev/mcp/
- Repository: https://github.com/LiquiHog/hogswap-mcp
- Changelog RSS feed: https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1.xml
- Changelog JSON feed: https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1.json
- HTML version of this page: https://verifymcp.io/servers/liquihog-hogswap-mcp/hogswap-v1