io.github.Ryvonetwork/ryvo-gateway
NPM · @RYVONETWORK/GATEWAY-MCP · SCANNED AUG 3
MCP server for Ryvo Gateway x402, Helius Wallet, and Tokens API market data.
Available components
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 returned HTTP 404. 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 86 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability63
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (fair).Partial
- Context-footprint check failed: tool/resource definitions use about 2238 tokens (~139/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 Management23
- Stability observed for 7 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
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 · @ryvonetwork/gateway-mcp
claude mcp add ryvonetwork-ryvo-gateway -- npx -y @ryvonetwork/gateway-mcp
codex mcp add ryvonetwork-ryvo-gateway -- npx -y @ryvonetwork/gateway-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ryvonetwork-ryvo-gateway": {
"type": "local",
"command": [
"npx",
"-y",
"@ryvonetwork/gateway-mcp"
],
"enabled": true
}
}
} openclaw mcp add ryvonetwork-ryvo-gateway --command npx --arg -y --arg @ryvonetwork/gateway-mcp
mcp_servers:
ryvonetwork-ryvo-gateway:
command: "npx"
args: ["-y", "@ryvonetwork/gateway-mcp"] {
"mcpServers": {
"ryvonetwork-ryvo-gateway": {
"command": "npx",
"args": [
"-y",
"@ryvonetwork/gateway-mcp"
]
}
}
} 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.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 2 Aug 26 +18
- Malware scan: unverified → pass ▲ security
- Stability: unverified → 0.20 ▲ functional
- 31 Jul 26 −6
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 +27
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- First check of Tool coverage: 36 functional
- First check of Schema quality: fail functional
- First check of Schema quality: fair functional
- First check of Schema quality: fail functional
- 26 Jul 26 41
First indexed and scored.
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
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/@ryvonetwork/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 0 packages
0 packages in the resolved dependency tree.
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.
ryvo_gateway_auth_call ~293
Generic escape hatch: call any Ryvo Gateway route, run the configured signer hook on a 402, and retry. For Tokens market-data questions, prefer the higher-level ryvo_token_quote / ryvo_token_resolve / ryvo_token_chart / ryvo_token_search / ryvo_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.
| 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 RYVO_SIGNER_COMMAND. |
| walletProfile | string | — | Optional wallet profile hint passed to the signer hook. |
No output schema declared.
No examples provided.
ryvo_gateway_call ~190
Call an Ryvo 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.
| 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.
ryvo_gateway_call_with_headers ~114
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.
| 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.
ryvo_gateway_catalog ~40
Fetch the live Ryvo Gateway route catalog, optionally scoped to a provider.
| Name | Type | Req | Description |
|---|---|---|---|
| baseUrl | string | — | — |
| provider | string | — | — |
No output schema declared.
No examples provided.
ryvo_gateway_complete_siwx ~91
Build a SIGN-IN-WITH-X header from a prepared auth envelope plus a wallet address and signature.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | — |
| chainId | string | — | — |
| prepareAuth | object | yes | Full JSON object returned by ryvo_gateway_prepare_auth (includes challenge.siwx after a 402). |
| signature | string | yes | — |
| signatureEncoding | string | — | — |
No output schema declared.
No examples provided.
ryvo_gateway_find_route ~75
Find routes in the live catalog by provider, surface, method, path substring, or access mode.
| Name | Type | Req | Description |
|---|---|---|---|
| accessMode | string | — | — |
| baseUrl | string | — | — |
| method | string | — | — |
| path | string | — | — |
| provider | string | — | — |
| surface | string | — | — |
No output schema declared.
No examples provided.
ryvo_gateway_health ~39
Check Ryvo Gateway health.
| Name | Type | Req | Description |
|---|---|---|---|
| baseUrl | string | — | Gateway base URL. Defaults to RYVO_GATEWAY_BASE_URL or production. |
No output schema declared.
No examples provided.
ryvo_gateway_prepare_auth ~123
Prepare wallet/payment authorization JSON for a Gateway route without signing, paying, or running local commands.
| 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.
ryvo_gateway_prepare_solana ~84
Prepare a Solana RPC or DAS Ryvo Gateway request object without sending it.
| 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.
ryvo_gateway_prepare_wallet ~97
Prepare a Helius Wallet Ryvo Gateway request object without sending it, including x402 or ryvo-channel paths.
| 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.
ryvo_token_batch_quote ~218
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 ryvo_token_quote in a loop, and over `npx -y @ryvonetwork/gateway-cli batch` shell commands. If inputs are canonical names/tickers (not mints), resolve each via ryvo_token_resolve first to get mints, then batch-quote.
| 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.
ryvo_token_chart ~201
USE THIS FIRST for any historical price / OHLCV / candle / time-window question about an Ryvo-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.
| Name | Type | Req | Description |
|---|---|---|---|
| assetId | string | yes | Canonical Ryvo 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.
ryvo_token_quote ~331
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 Ryvo 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 ryvo_token_resolve first to get the assetId.
| Name | Type | Req | Description |
|---|---|---|---|
| assetId | string | yes | Canonical Ryvo assetId (e.g. 'bitcoin', 'solana', 'tesla', 'gold', 'usd'). Use ryvo_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 RYVO_SIGNER_COMMAND. Tokens routes use SIWX (free). |
| walletProfile | string | — | — |
No output schema declared.
No examples provided.
ryvo_token_resolve ~142
Resolve a free-text reference (human name, ticker, or ambiguous phrase like 'tesla', 'gold', 'btc', 'BTC ETF') to a canonical Ryvo assetId, primary mint, and preferred market view. Free over SIWX. Call this BEFORE ryvo_token_quote / ryvo_token_chart whenever the user gives a name/ticker instead of a canonical assetId. Cache the result for the rest of the task.
| 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.
ryvo_token_search ~181
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 ryvo_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 Ryvo-tracked classes (crypto, tokenized stocks, ETFs, treasuries, metals, currencies).
| 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.