MCP.Market

Ryvo Protocol MCP server

by Ryvonetwork·io.github.Ryvonetwork/ryvo-protocol·v0.5.1

MCP server for Ryvo Protocol state reads and prepare-only payment-channel actions.

B80/100grade B
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
New

0 stars36 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • ryvo_protocol_channel

    Fetch a channel by payer/payee participant IDs.

  • ryvo_protocol_clearing_preview

    Preview BLS clearing-round message size and settlement-event compression for a candidate participant/channel count.

  • ryvo_protocol_config

    Fetch Ryvo Protocol global config and token registry.

  • ryvo_protocol_headroom

    Compute gateway spendable headroom for a channel.

  • ryvo_protocol_participant

    Fetch a participant account by owner public key.

  • ryvo_protocol_prepare_action

    Return a concrete prepare-only instruction/account/message plan for any supported Ryvo Protocol action.

  • ryvo_protocol_prepare_gateway_commitment

    Prepare a gateway cumulative commitment payload and message bytes. Does not sign.

  • ryvo_protocol_token

    Resolve the canonical devnet USDC token metadata from env, registry, or deployment config.

  • ryvo_protocol_verify_gateway_commitment

    Verify 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

no findings
  • 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
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 all

After 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-skills

Other 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.