Ryvo Protocol MCP server
io.github.Ryvonetwork/ryvo-protocol·v0.5.1MCP server for Ryvo Protocol state reads and prepare-only payment-channel actions.
0 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Ryvo Protocol yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ryvo Protocol tools (9)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
ryvo_protocol_channelFetch a channel by payer/payee participant IDs.
ryvo_protocol_clearing_previewPreview BLS clearing-round message size and settlement-event compression for a candidate participant/channel count.
ryvo_protocol_configFetch Ryvo Protocol global config and token registry.
ryvo_protocol_headroomCompute gateway spendable headroom for a channel.
ryvo_protocol_participantFetch a participant account by owner public key.
ryvo_protocol_prepare_actionReturn a concrete prepare-only instruction/account/message plan for any supported Ryvo Protocol action.
ryvo_protocol_prepare_gateway_commitmentPrepare a gateway cumulative commitment payload and message bytes. Does not sign.
ryvo_protocol_tokenResolve the canonical devnet USDC token metadata from env, registry, or deployment config.
ryvo_protocol_verify_gateway_commitmentVerify a signed gateway cumulative commitment envelope.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 143 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
How Ryvo Protocol compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 65% of 1,761 Finance servers
- Tools
- 9
- the typical Finance server has 8
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 36
- more than 28% of 421 Finance servers with a package
What its tools let an agent do: 9 read
Install Ryvo Protocol in Claude Code, Cursor or VS Code
Runs npx -y @ryvonetwork/protocol-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ryvo-protocol -- npx -y @ryvonetwork/protocol-mcp
What the publisher says
From the Ryvo Protocol repository's README, as published. We do not edit it. Read it on GitHub
Ryvo Agentic Tools
Agent-facing tools for discovering, authenticating, and calling Ryvo Gateway routes.
One-Step Setup
setup --target all is the one command that installs everything Ryvo agents need:
- Bundled skills into ~/.agents/skills, ~/.codex/skills, ~/.claude/skills.
- Default SIWX signer wallet at ~/.ryvo/wallets/default.json.
- Global CLI bins on PATH: Ryvo, ryvo-gateway, ryvo-wallet, ryvo-protocol (via npm install -g @ryvonetwork/gateway-cli @ryvonetwork/agent-wallet @ryvonetwork/protocol-cli).
- Local agent reference at ~/.ryvo/llm.txt.
- Ryvo MCP server registration for Codex, Claude Desktop, Claude Code, Cursor, Windsurf, and a generic config (existing entries preserved, backups written).
npx -y @ryvonetwork/agentic@latest setup --target allAfter it finishes, restart your agent client and the agent can call Ryvo directly via:
- The Ryvo MCP tools (ryvotokenquote, ryvotokenresolve, ryvotokenchart, ryvotokensearch, ryvotokenbatchquote, ryvogatewaycall, ryvogatewayauthcall, ...).
- The bare CLIs: ryvo -p bitcoin, ryvo quote bitcoin solana usdt, ryvo-gateway auth call GET ..., etc.
Opt-out flags:
- --skip-global-cli — do not run npm install -g. Bare CLI bins will not be on PATH; use npx -y @ryvonetwork/gateway-cli ... instead.
- --skip-wallet-setup — only valid for install-skills when another signer wallet is already configured.
Supported setup targets:
npx -y @ryvonetwork/agentic setup --target codex # ~/.codex/config.toml
npx -y @ryvonetwork/agentic setup --target claude-desktop # standalone Claude Desktop GUI app config
npx -y @ryvonetwork/agentic setup --target claude-code # ~/.claude.json (Claude Code CLI agent)
npx -y @ryvonetwork/agentic setup --target cursor # ~/.cursor/mcp.json
npx -y @ryvonetwork/agentic setup --target windsurf
npx -y @ryvonetwork/agentic setup --target generic # ~/.ryvo/mcp.json
npx -y @ryvonetwork/agentic setup --target all --dry-run--target all writes to every adapter listed above. Claude Desktop (the standalone macOS/Windows GUI app) and Claude Code (the terminal CLI agent) read MCP servers from different files; --target all registers in both. After setup, restart your agent client so it re-reads the MCP server list.
Setup creates ~/.ryvo/wallets/default.json. @ryvonetwork/agent-wallet only signs Tokens API SIWX challenges (sign-in-with-x). For Gateway routes that require x402 exact payment or other auth, set RYVOSIGNERCOMMAND to a signer that returns PAYMENT-SIGNATURE / X-PAYMENT.
When RYVOSIGNERCOMMAND runs
- Gateway MCP: only when calling ryvogatewayauthcall and the gateway responds with HTTP 402. The MCP spawns RYVOSIGNERCOMMAND once, piping the normalized auth-request JSON to stdin (same shape as ryvogatewayprepareauth). The process must exit 0 and print JSON to stdout: auth headers, or SIWX fallback (address, signature, optional signatureEncoding).
- gateway-cli: ryvo-gateway auth call and batch reuse the same requestGateway path: after any 402 from the Gateway, RYVOSIGNERCOMMAND (or --auth-driver) runs if set. auth prepare / doctor never spawn the signer.
On Windows, when the signer command begins with npx/npm/pnpm/yarn, Node may run it via cmd shell. Treat RYVOSIGNERCOMMAND as equivalent to trusting a shell snippet if an attacker controls it.
Skills And Wallet
Install all Ryvo skills into every supported agent skill directory (~/.agents/skills, ~/.codex/skills, ~/.claude/skills), and create the default convenience wallet used for SIWX/auth calls:
npx -y @ryvonetwork/agentic install-skillsOther install targets:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ryvo Protocol: common questions
- Is Ryvo Protocol MCP server safe?
- Mostly: it is graded B (80/100). Read the Ryvo Protocol safety report
- How do I install Ryvo Protocol?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ryvo Protocol need an API key?
- No secret keys are declared. It reads 3 settings from the environment.
- Is Ryvo Protocol maintained?
- The last commit was 180 days ago (2026-05-08). The latest release is v0.5.1.
- What can I use instead of Ryvo Protocol?
- Servers from other publishers that do the same job: three.ws Agent Payments MCP server, Yolfi Payments MCP server and X402 List MCP server.
- How does Ryvo Protocol compare with other Finance MCP servers?
- safety score 80/100 (higher than 65% of 1,761 Finance servers); tools 9 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Ryvo Protocol
Same job from other publishers: the closest match first, then the best rated.
- three.ws Agent PaymentsGoverned x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.not reviewedEstablishedB
- Yolfi Payments MCPLet AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.not reviewedEstablishedA
- X402 ListFind and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.not reviewedEstablishedA
- SatGate – Economic Firewall for AI AgentsBudget, payment and audit controls for AI agent API calls and MCP tool calls.not reviewedEstablishedA
- QuickbooksMCP server for QuickBooks Online (Intuit) — customers, invoices, payments, items, accounts, P&Lnot reviewedEstablishedB