Agentic Tools

Ryvo publishes agent-facing tools in the Ryvonetwork/ryvo-agentic repository. The repo contains gateway tools, protocol tools, Codex-style skills, and LLM-readable docs.

Repository layout

Path	Publishes	Purpose
`cli/`	`@ryvonetwork/gateway-cli`	Discover gateway routes and call them from agent workflows.
`mcp/`	`@ryvonetwork/gateway-mcp`	MCP server for gateway route discovery and calls.
`protocol-cli/`	`@ryvonetwork/protocol-cli`	Read protocol state and prepare unsigned protocol actions.
`protocol-mcp/`	`@ryvonetwork/protocol-mcp`	MCP server for protocol read and prepare tools.
`skills/ryvo-gateway/`	Codex-style skill	Gateway catalog, x402, and SIWX workflows.
`skills/ryvo-protocol/`	Codex-style skill	Participants, balances, channels, settlement, withdrawals, and BLS caveats.
`skills/ryvo-gateway-payment-channels/`	Codex-style skill	Channel-backed gateway calls using signed cumulative commitments.

Live protocol defaults

Field	Value
Program ID	`3UyUFeNsUYPpM6hMRf7H8wg3MKEXQ82rqnsXhZrUwgSD`
Cluster	`devnet`
Chain ID	`1`
Message domain	`a58a109a38f14cc27ef174135176cab3`
Gateway-channel token	Official devnet USDC, mint `4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`

The official devnet USDC token_id is resolved from the protocol TokenRegistry or from RYVO_PROTOCOL_DEVNET_USDC_TOKEN_ID. Do not hardcode demo token IDs in agent integrations.

CLI packages

npx @ryvonetwork/gateway-cli health
npx @ryvonetwork/gateway-cli catalog
npx @ryvonetwork/protocol-cli config
npx @ryvonetwork/protocol-cli token show
npx @ryvonetwork/protocol-cli participant show --owner <owner>
npx @ryvonetwork/protocol-cli channel headroom --payer-id <payer-id> --payee-id <payee-id> --latest-accepted <amount>

The protocol CLI is read + prepare only. It can prepare transactions and gateway commitment payloads, but it does not store private keys, sign messages, or broadcast transactions.

MCP packages

Gateway MCP:

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

Protocol MCP:

{
  "mcpServers": {
    "ryvo-protocol": {
      "command": "npx",
      "args": ["-y", "@ryvonetwork/protocol-mcp"],
      "env": {
        "SOLANA_DEVNET_RPC_URL": "https://api.devnet.solana.com"
      }
    }
  }
}

The protocol MCP exposes the resource ryvo://protocol/llm.txt. Like the protocol CLI, it is read + prepare only and never signs or submits transactions.

LLM text

File	Scope
`llm.txt`	Gateway-focused short context for agent clients.
`llms.txt`	Gateway-focused expanded context for agent clients.
`protocol-mcp/llm.txt`	Protocol-focused short context, also exposed through MCP as `ryvo://protocol/llm.txt`.
`protocol-mcp/llms.txt`	Protocol-focused expanded context.

Payment-channel guardrails

Gateway channel payments use signed cumulative commitments against locked channel collateral. For /v1/ryvo-channel/... routes, agents should:

Open a channel to the gateway merchant participant.
Lock official devnet USDC into that channel.
Sign one cumulative commitment per request.
Send X-Ryvo-Request-Id and RYVO-COMMITMENT with the gateway call.

Tokens SIWX routes remain auth-only and free. They do not use payment channels.

Protocol caveats

Participant withdrawals are instant on the live devnet deployment.
Unilateral channel unlocks take 72 hours.
Cooperative channel unlocks are immediate when both parties agree.
Ryvo BLS is Ryvo-specific. It is not a generic IETF hash-to-curve BLS ciphersuite, so clients must use the shared Ryvo implementation and test vectors.
BLS key rotation does not exist yet. If a BLS key is lost or compromised, the participant should migrate to a new participant identity for future BLS clearing.

Introduction

Concepts

Routes

Integrate

Agentic

Reference

Repository layout

Live protocol defaults

CLI packages

MCP packages

LLM text

Payment-channel guardrails

Protocol caveats

​Repository layout

​Live protocol defaults

​CLI packages

​MCP packages

​LLM text

​Payment-channel guardrails

​Protocol caveats

Repository layout

Live protocol defaults

CLI packages

MCP packages

LLM text

Payment-channel guardrails

Protocol caveats