# io.github.Agonx402/agon-gateway (npm · @agonx402/gateway-mcp)

MCP server for Agon Gateway x402, Helius Wallet, and Tokens API market data.

- Trust score: 65/100 (medium)
- Change this week: −6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@agonx402/gateway-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp.md), [page](https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp)

## Channel facts

- Registry: `npm`
- Package: `@agonx402/gateway-mcp`
- Version: `0.4.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, 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-03.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL redirects; it must resolve directly.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 92 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 73/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2206 tokens (~137/item across 16 items; 15 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 79/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 36% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add agonx402-agon-gateway -- npx -y @agonx402/gateway-mcp
```

### Codex

```bash
codex mcp add agonx402-agon-gateway -- npx -y @agonx402/gateway-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agonx402-agon-gateway": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@agonx402/gateway-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add agonx402-agon-gateway --command npx --arg -y --arg @agonx402/gateway-mcp
```

### Hermes

```yaml
mcp_servers:
  agonx402-agon-gateway:
    command: "npx"
    args: ["-y", "@agonx402/gateway-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "agonx402-agon-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@agonx402/gateway-mcp"
      ]
    }
  }
}
```

## 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-02 (score 65, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-01 (score 61, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-07-31 (score 46, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 71, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 71)

First indexed and scored.

## MCP tools (15)

### `agon_gateway_health` (~37 tokens)

Check Agon Gateway health.

Input parameters:

- `baseUrl` (string): Gateway base URL. Defaults to AGON_GATEWAY_BASE_URL or production.

### `agon_gateway_catalog` (~39 tokens)

Fetch the live Agon Gateway route catalog, optionally scoped to a provider.

Input parameters:

- `baseUrl` (string)
- `provider` (string)

### `agon_gateway_find_route` (~74 tokens)

Find routes in the live catalog by provider, surface, method, path substring, or access mode.

Input parameters:

- `accessMode` (string)
- `baseUrl` (string)
- `method` (string)
- `path` (string)
- `provider` (string)
- `surface` (string)

### `agon_gateway_prepare_solana` (~83 tokens)

Prepare a Solana RPC or DAS Agon Gateway request object without sending it.

Input parameters:

- `accessMode` (string)
- `baseUrl` (string)
- `cluster` (string)
- `method` (string, required)
- `params` (required): RPC params array or DAS params object.
- `provider` (string)
- `surface` (string, required)

### `agon_gateway_prepare_wallet` (~95 tokens)

Prepare a Helius Wallet Agon Gateway request object without sending it, including x402 or agon-channel paths.

Input parameters:

- `accessMode` (string)
- `action` (string, required)
- `baseUrl` (string)
- `cluster` (string)
- `query`
- `wallet` (string): Wallet address for non-batch wallet actions.
- `wallets` (array): Wallet list for batch-identity.

### `agon_gateway_call` (~189 tokens)

Call an Agon Gateway route. Use without payment/SIWX headers to issue a challenge, then retry with PAYMENT-SIGNATURE, X-PAYMENT, or SIGN-IN-WITH-X. Devnet RPC/DAS/Wallet routes settle in devnet USDC; mainnet routes settle in mainnet USDC; Tokens API SIWX routes are free.

Input parameters:

- `baseUrl` (string)
- `body`: JSON body. Omit for GET/HEAD.
- `headers` (object)
- `method` (string, required): HTTP method, for example GET or POST.
- `path` (string, required): Gateway path, for example /v1/catalog.
- `paymentSignature` (string): Value for PAYMENT-SIGNATURE.
- `query`
- `siwx` (string): Value for SIGN-IN-WITH-X.
- `xPayment` (string): Value for X-PAYMENT.

### `agon_gateway_prepare_auth` (~122 tokens)

Prepare wallet/payment authorization JSON for a Gateway route without signing, paying, or running local commands.

Input parameters:

- `accessMode` (string)
- `address` (string): Optional wallet address used to render a concrete SIWX signing message.
- `baseUrl` (string)
- `body`: JSON body. Omit for GET/HEAD.
- `chainId` (string): Optional SIWX chain ID to select from the challenge.
- `headers` (object)
- `method` (string, required)
- `path` (string, required)
- `query`

### `agon_gateway_complete_siwx` (~89 tokens)

Build a SIGN-IN-WITH-X header from a prepared auth envelope plus a wallet address and signature.

Input parameters:

- `address` (string, required)
- `chainId` (string)
- `prepareAuth` (object, required): Full JSON object returned by agon_gateway_prepare_auth (includes challenge.siwx after a 402).
- `signature` (string, required)
- `signatureEncoding` (string)

### `agon_gateway_call_with_headers` (~113 tokens)

Call a Gateway route with caller-supplied auth/payment headers. MCP does not sign, pay, or execute wallet commands. Devnet routes expect devnet-USDC payment headers; mainnet routes expect mainnet-USDC headers; Tokens API SIWX routes are free.

Input parameters:

- `baseUrl` (string)
- `body`: JSON body. Omit for GET/HEAD.
- `headers` (object, required)
- `method` (string, required)
- `path` (string, required)
- `query`

### `agon_gateway_auth_call` (~286 tokens)

Generic escape hatch: call any Agon Gateway route, run the configured signer hook on a 402, and retry. For Tokens market-data questions, prefer the higher-level agon_token_quote / agon_token_resolve / agon_token_chart / agon_token_search / agon_token_batch_quote tools -- they pre-format the route, parse the response, and avoid shell quoting. Use this tool only for routes those higher-level tools do not cover (custom Tokens routes, Solana RPC, DAS, Helius Wallet, payment-channel routes). Devnet RPC/DAS/Wallet routes pay in devnet USDC; mainnet RPC/DAS/Wallet routes pay in mainnet USDC; Tokens API SIWX routes are free on either cluster. The signer must hold the USDC mint for the cluster of the route.

Input parameters:

- `baseUrl` (string)
- `body`: JSON body. Omit for GET/HEAD.
- `dailyLimitUsd` (string): Optional x402 daily authorized spend limit.
- `headers` (object)
- `maxAmountUsd` (string): Optional x402 max per request.
- `method` (string, required)
- `path` (string, required)
- `query`
- `signerCommand` (string): Signer hook command. Defaults to AGON_SIGNER_COMMAND.
- `walletProfile` (string): Optional wallet profile hint passed to the signer hook.

### `agon_token_quote` (~327 tokens)

USE THIS FIRST for any current price / quote / market-cap / 24h volume / supply / liquidity question about a single asset -- crypto (BTC, SOL, ETH, USDC, USDT, ...), tokenized stock (TSLA, AAPL, MSFT, NVDA, ...), ETF, treasury, metal (gold, silver), or fiat currency. Free over SIWX (no payment). Returns the canonical market view plus optional variant view. Do NOT fall back to web search, shell commands, or third-party finance APIs for this -- prefer this tool. Pass either an Agon canonical assetId (e.g. 'bitcoin', 'solana', 'tesla', 'gold', 'usd') or include a Solana mint to look up a specific tokenized variant. If only a free-text ticker/name is known, call agon_token_resolve first to get the assetId.

Input parameters:

- `assetId` (string, required): Canonical Agon assetId (e.g. 'bitcoin', 'solana', 'tesla', 'gold', 'usd'). Use agon_token_resolve first if only a free-text ticker/name is known.
- `baseUrl` (string)
- `mint` (string): Solana mint for a tokenized variant. When set, calls /v1/x402/tokens/assets/:assetId/variant-market?mint=<mint>. Requires assetId.
- `signerCommand` (string): Signer hook command. Defaults to AGON_SIGNER_COMMAND. Tokens routes use SIWX (free).
- `walletProfile` (string)

### `agon_token_resolve` (~139 tokens)

Resolve a free-text reference (human name, ticker, or ambiguous phrase like 'tesla', 'gold', 'btc', 'BTC ETF') to a canonical Agon assetId, primary mint, and preferred market view. Free over SIWX. Call this BEFORE agon_token_quote / agon_token_chart whenever the user gives a name/ticker instead of a canonical assetId. Cache the result for the rest of the task.

Input parameters:

- `baseUrl` (string)
- `ref` (string, required): Free-text reference: name, ticker, symbol, or ambiguous phrase.
- `signerCommand` (string)
- `walletProfile` (string)

### `agon_token_chart` (~200 tokens)

USE THIS FIRST for any historical price / OHLCV / candle / time-window question about an Agon-tracked asset (crypto, tokenized stock, ETF, treasury, metal, currency). Free over SIWX. Use for historical prices, custom time windows (24h, 7D, 30D, ...), and candle aggregation. Do NOT fall back to web search, shell commands, or third-party finance APIs for this.

Input parameters:

- `assetId` (string, required): Canonical Agon assetId.
- `baseUrl` (string)
- `from` (string): Optional ISO timestamp or unix-ms lower bound.
- `interval` (string): Candle interval, e.g. '1H', '4H', '1D', '1W'. Defaults to '1D'.
- `signerCommand` (string)
- `to` (string): Optional ISO timestamp or unix-ms upper bound.
- `walletProfile` (string)

### `agon_token_search` (~179 tokens)

USE THIS FIRST for any 'find an asset / what tokens exist for X / list assets matching Y' question. Free over SIWX. Returns ranked candidates with assetIds, symbols, and short descriptions for queries like 'bitcoin etf', 'tokenized treasury', 'gold mining', 'AI tokens'. Prefer agon_token_resolve when the query is a single name/ticker; use search when the query is broader or ambiguous. Do NOT use web search for asset discovery on Agon-tracked classes (crypto, tokenized stocks, ETFs, treasuries, metals, currencies).

Input parameters:

- `baseUrl` (string)
- `limit` (integer): Max results, 1-50. Defaults to 10.
- `q` (string, required): Free-text query.
- `signerCommand` (string)
- `walletProfile` (string)

### `agon_token_batch_quote` (~215 tokens)

USE THIS FIRST for any multi-asset quote / 'price of X, Y, Z' / batch market-data question when the inputs are Solana mints. Free over SIWX. Up to 50 mints issues a single GET /v1/x402/tokens/assets/variant-markets; >50 issues POST /v1/x402/tokens/assets/market-snapshots (max 250). One round trip, no shell quoting. Prefer this over agon_token_quote in a loop, and over `npx -y @agonx402/gateway-cli batch` shell commands. If inputs are canonical names/tickers (not mints), resolve each via agon_token_resolve first to get mints, then batch-quote.

Input parameters:

- `baseUrl` (string)
- `mints` (array, required): Solana mint addresses (base58). 1-50 issues a GET; 51-250 issues a POST.
- `signerCommand` (string)
- `walletProfile` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp#diagnostics

## Score history

- 2026-08-03: 65
- 2026-08-02: 65
- 2026-08-01: 61
- 2026-07-31: 46
- 2026-07-30: 71
- 2026-07-29: 71
- 2026-07-28: 71
- 2026-07-27: 71
- 2026-07-26: 71

## Links

- npm package: https://www.npmjs.com/package/@agonx402/gateway-mcp
- Socket report: https://socket.dev/npm/package/@agonx402/gateway-mcp
- Changelog RSS feed: https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/agonx402-agon-gateway/agonx402-gateway-mcp