io.github.Agonx402/agon-gateway

NPM · @AGONX402/GATEWAY-MCP · SCANNED AUG 3

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

Available components

−6 this week 65 65 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security100

No malware found by supply-chain analysis.Pass
No known CVEs affecting this package version or its production dependencies.Pass
No install/post-install scripts declared.Pass
No production dependencies, so there is no dependency health to assess. View diagnostics → Pass

Provenance & Transparency19

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 92 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability73

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
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. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage79

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
36% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @agonx402/gateway-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +4
- Stability: unverified → 0.23 ▲ functional
1 Aug 26 +15
- Malware scan: unverified → pass ▲ security
31 Jul 26 −25
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 71

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@agonx402/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 0 packages

0 packages in the resolved dependency tree.

MCP tools — 15 exposed · ~2,187 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

agon_gateway_auth_call ~286

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 Output Examples

Name	Type	Req	Description
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	yes	—
path	string	yes	—
query	—	—	—
signerCommand	string	—	Signer hook command. Defaults to AGON_SIGNER_COMMAND.
walletProfile	string	—	Optional wallet profile hint passed to the signer hook.

No output schema declared.

No examples provided.

agon_gateway_call ~189

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 Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
body	—	—	JSON body. Omit for GET/HEAD.
headers	object	—	—
method	string	yes	HTTP method, for example GET or POST.
path	string	yes	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.

No output schema declared.

No examples provided.

agon_gateway_call_with_headers ~113

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 Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
body	—	—	JSON body. Omit for GET/HEAD.
headers	object	yes	—
method	string	yes	—
path	string	yes	—
query	—	—	—

No output schema declared.

No examples provided.

agon_gateway_catalog ~39

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

Input Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
provider	string	—	—

No output schema declared.

No examples provided.

agon_gateway_complete_siwx ~89

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

Input Output Examples

Name	Type	Req	Description
address	string	yes	—
chainId	string	—	—
prepareAuth	object	yes	Full JSON object returned by agon_gateway_prepare_auth (includes challenge.siwx after a 402).
signature	string	yes	—
signatureEncoding	string	—	—

No output schema declared.

No examples provided.

agon_gateway_find_route ~74

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

Input Output Examples

Name	Type	Req	Description
accessMode	string	—	—
baseUrl	string	—	—
method	string	—	—
path	string	—	—
provider	string	—	—
surface	string	—	—

No output schema declared.

No examples provided.

agon_gateway_health ~37

Check Agon Gateway health.

Input Output Examples

Name	Type	Req	Description
baseUrl	string	—	Gateway base URL. Defaults to AGON_GATEWAY_BASE_URL or production.

No output schema declared.

No examples provided.

agon_gateway_prepare_auth ~122

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

Input Output Examples

Name	Type	Req	Description
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	yes	—
path	string	yes	—
query	—	—	—

No output schema declared.

No examples provided.

agon_gateway_prepare_solana ~83

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

Input Output Examples

Name	Type	Req	Description
accessMode	string	—	—
baseUrl	string	—	—
cluster	string	—	—
method	string	yes	—
params	—	yes	RPC params array or DAS params object.
provider	string	—	—
surface	string	yes	—

No output schema declared.

No examples provided.

agon_gateway_prepare_wallet ~95

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

Input Output Examples

Name	Type	Req	Description
accessMode	string	—	—
action	string	yes	—
baseUrl	string	—	—
cluster	string	—	—
query	—	—	—
wallet	string	—	Wallet address for non-batch wallet actions.
wallets	array	—	Wallet list for batch-identity.

No output schema declared.

No examples provided.

agon_token_batch_quote ~215

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 Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
mints	array	yes	Solana mint addresses (base58). 1-50 issues a GET; 51-250 issues a POST.
signerCommand	string	—	—
walletProfile	string	—	—

No output schema declared.

No examples provided.

agon_token_chart ~200

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 Output Examples

Name	Type	Req	Description
assetId	string	yes	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	—	—

No output schema declared.

No examples provided.

agon_token_quote ~327

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 Output Examples

Name	Type	Req	Description
assetId	string	yes	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	—	—

No output schema declared.

No examples provided.

agon_token_resolve ~139

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 Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
ref	string	yes	Free-text reference: name, ticker, symbol, or ambiguous phrase.
signerCommand	string	—	—
walletProfile	string	—	—

No output schema declared.

No examples provided.

agon_token_search ~179

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 Output Examples

Name	Type	Req	Description
baseUrl	string	—	—
limit	integer	—	Max results, 1-50. Defaults to 10.
q	string	yes	Free-text query.
signerCommand	string	—	—
walletProfile	string	—	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	71
27 Jul	71
28 Jul	71
29 Jul	71
30 Jul	71
31 Jul	46
1 Aug	61
2 Aug	65
3 Aug	65