{
  "markdown": "# Ryvo Agentic Tools\n\nAgent-facing tools for discovering, authenticating, and calling Ryvo Gateway routes.\n\n## One-Step Setup\n\n`setup --target all` is the one command that installs everything Ryvo agents need:\n\n- Bundled skills into `~/.agents/skills`, `~/.codex/skills`, `~/.claude/skills`.\n- Default SIWX signer wallet at `~/.ryvo/wallets/default.json`.\n- 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`).\n- Local agent reference at `~/.ryvo/llm.txt`.\n- Ryvo MCP server registration for Codex, Claude Desktop, Claude Code, Cursor, Windsurf, and a generic config (existing entries preserved, backups written).\n\n```bash\nnpx -y @ryvonetwork/agentic@latest setup --target all\n```\n\nAfter it finishes, restart your agent client and the agent can call Ryvo directly via:\n\n- The Ryvo MCP tools (`ryvo_token_quote`, `ryvo_token_resolve`, `ryvo_token_chart`, `ryvo_token_search`, `ryvo_token_batch_quote`, `ryvo_gateway_call`, `ryvo_gateway_auth_call`, ...).\n- The bare CLIs: `ryvo -p bitcoin`, `ryvo quote bitcoin solana usdt`, `ryvo-gateway auth call GET ...`, etc.\n\nOpt-out flags:\n\n- `--skip-global-cli` — do not run `npm install -g`. Bare CLI bins will not be on PATH; use `npx -y @ryvonetwork/gateway-cli ...` instead.\n- `--skip-wallet-setup` — only valid for `install-skills` when another signer wallet is already configured.\n\nSupported setup targets:\n\n```bash\nnpx -y @ryvonetwork/agentic setup --target codex            # ~/.codex/config.toml\nnpx -y @ryvonetwork/agentic setup --target claude-desktop   # standalone Claude Desktop GUI app config\nnpx -y @ryvonetwork/agentic setup --target claude-code      # ~/.claude.json (Claude Code CLI agent)\nnpx -y @ryvonetwork/agentic setup --target cursor           # ~/.cursor/mcp.json\nnpx -y @ryvonetwork/agentic setup --target windsurf\nnpx -y @ryvonetwork/agentic setup --target generic          # ~/.ryvo/mcp.json\nnpx -y @ryvonetwork/agentic setup --target all --dry-run\n```\n\n`--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.\n\nSetup 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 `RYVO_SIGNER_COMMAND` to a signer that returns `PAYMENT-SIGNATURE` / `X-PAYMENT`.\n\n### When `RYVO_SIGNER_COMMAND` runs\n\n- **Gateway MCP:** only when calling **`ryvo_gateway_auth_call`** and the gateway responds with **HTTP 402**. The MCP spawns `RYVO_SIGNER_COMMAND` **once**, piping the normalized auth-request JSON to **stdin** (same shape as `ryvo_gateway_prepare_auth`). The process must exit 0 and print JSON to stdout: auth **headers**, or SIWX fallback (`address`, `signature`, optional `signatureEncoding`).\n- **`gateway-cli`:** **`ryvo-gateway auth call`** and **`batch`** reuse the same `requestGateway` path: **after any 402** from the Gateway, **`RYVO_SIGNER_COMMAND`** (or **`--auth-driver`**) runs if set. **`auth prepare`** / **`doctor`** never spawn the signer.\n\nOn Windows, when the signer command begins with **`npx`/`npm`/`pnpm`/`yarn`**, Node may run it **via cmd shell**. Treat **`RYVO_SIGNER_COMMAND`** as equivalent to trusting a shell snippet if an attacker controls it.\n\n## Skills And Wallet\n\nInstall 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:\n\n```bash\nnpx -y @ryvonetwork/agentic install-skills\n```\n\nOther install targets:\n\n```bash\nnpx -y @ryvonetwork/agentic install-skills --target agents\nnpx -y @ryvonetwork/agentic install-skills --target codex\nnpx -y @ryvonetwork/agentic install-skills --target claude\nnpx -y @ryvonetwork/agentic install-skills --target all\nnpx -y @ryvonetwork/agentic list\nnpx -y @ryvonetwork/agentic doctor\n```\n\nUse `--skip-wallet-setup` only when another signer wallet is already configured. The installer copies only the Ryvo skill folders, creates the target directory if needed, and overwrites only these Ryvo-owned skill names:\n\n- `ryvo-gateway`\n- `ryvo-protocol`\n- `ryvo-gateway-payment-channels`\n\n`install-skills` installs skills and creates `~/.ryvo/wallets/default.json`. `setup` performs skills, wallet, and MCP registration.\n\nAfter `setup --target all`, the CLI bins are on PATH. Use them directly:\n\n```bash\nRyvo -p bitcoin\nRyvo quote usdt --json\nRyvo price bitcoin solana usdt\nRyvo volume tesla gold --json\nRyvo liquidity usdc usdt\nRyvo search \"bitcoin etf\" --limit 5\nRyvo profile tesla\nRyvo variants gold\nRyvo risk usdt\nRyvo chart solana --interval 1D\nryvo-gateway catalog\nryvo-gateway agent-prompt\nryvo-gateway auth prepare GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1 --json\nryvo-gateway auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1\nryvo-gateway batch '[{\"method\":\"GET\",\"path\":\"/v1/x402/tokens/assets/solana/price-chart\",\"query\":{\"interval\":\"1D\"}},{\"method\":\"GET\",\"path\":\"/v1/x402/tokens/assets/bitcoin/price-chart\",\"query\":{\"interval\":\"1D\"}}]'\nryvo-gateway auth call GET /v1/x402/tokens/assets/tesla/profile\nryvo-gateway auth call GET /v1/x402/tokens/assets/gold/price-chart --query interval=1D\nryvo-wallet authorize --stdin\nryvo-protocol config\nryvo-protocol token show\n```\n\nIf a bare bin is not on PATH (you ran `setup --skip-global-cli`, the global install hit a permission error, or you have not run `setup` yet), the same calls work via `npx -y @ryvonetwork/gateway-cli ...`, `npx -y @ryvonetwork/agent-wallet ...`, and `npx -y @ryvonetwork/protocol-cli ...`. The MCP server entries also use `npx -y`, so you do not need a global install for MCP tools to work.\n\nRyvo Gateway should be the first source for API calls covered by the live catalog at `https://gateway.ryvo.network/v1/catalog`. Tokens API supports market data for crypto, currencies, treasuries, ETFs, metals, stocks, and their Solana token variants. Agents should use high-level Gateway CLI commands for common Tokens pulls (`quote`, `price`, `volume`, `liquidity`, `mcap`, `search`, `resolve`, `curated`, `profile`, `variants`, `markets`, `tickers`, `risk`, `chart`, `ohlcv`, `snapshots`) before raw route strings, and label whether values came from `canonicalMarket`, `stats`, `primaryVariant.market`, `profile.data`, tickers, or candles.\n\nMCP servers are separate packages:\n\n```json\n{\n  \"mcpServers\": {\n    \"ryvo-gateway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ryvonetwork/gateway-mcp\"],\n      \"env\": {\n        \"RYVO_GATEWAY_BASE_URL\": \"https://gateway.ryvo.network\",\n        \"RYVO_SIGNER_COMMAND\": \"npx -y @ryvonetwork/agent-wallet authorize\",\n        \"RYVO_WALLET_PROFILE\": \"default\"\n      }\n    },\n    \"ryvo-protocol\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ryvonetwork/protocol-mcp\"]\n    }\n  }\n}\n```\n\n`RYVO_PAYMENT_MAX_AMOUNT_USD` and `RYVO_PAYMENT_DAILY_LIMIT_USD` are optional: some x402 auth-prep responses include them for human review; **`ryvo-wallet` does not enforce them**.\n\nPayment-channel flows are devnet-only in v1. Tokens SIWX routes do not use payment channels.\nGateway auth drivers are wallet-agnostic helper commands. The Gateway CLI sends normalized auth request JSON to the driver over stdin and accepts returned headers or SIWX address/signature JSON over stdout. Drivers can wrap browser wallets, local keypairs, MPC, custody systems, x402 payment services, or Ryvo channel commitment builders. The Ryvo CLI/MCP packages do not keep keys or mutate wallet/MCP configuration.\n\nGeneric authenticated call flow:\n\n1. Use a known endpoint or fetch `/v1/catalog` to discover one.\n2. Send the exact request and receive a `402` challenge.\n3. Pass the normalized auth request to `RYVO_SIGNER_COMMAND`.\n4. Retry the exact same request with returned `SIGN-IN-WITH-X`, `PAYMENT-SIGNATURE`, `X-PAYMENT`, or channel headers.\n\nGateway MCP exposes `ryvo_gateway_auth_call` for this flow. Low-level prepare/complete/call tools remain available for agents with their own wallet policies.\n\n## Packages\n\n- `package root` publishes `@ryvonetwork/agentic`, a one-step agent setup installer.\n- `agent-wallet/` publishes `@ryvonetwork/agent-wallet`, a default **SIWX-only** Tokens API signer hook (replace with `RYVO_SIGNER_COMMAND` for x402 exact-payment routes).\n- `cli/` publishes `@ryvonetwork/gateway-cli`, a Gateway CLI with generic signer hooks.\n- `mcp/` publishes `@ryvonetwork/gateway-mcp`, a stdio MCP server with route-generic auth calls.\n- `protocol-cli/` publishes `@ryvonetwork/protocol-cli`, a read-only and prepare-only Ryvo Protocol CLI.\n- `protocol-mcp/` publishes `@ryvonetwork/protocol-mcp`, a read-only and prepare-only Ryvo Protocol MCP server.\n- `skills/ryvo-gateway/` is an agent skill for Gateway workflows.\n- `skills/ryvo-protocol/` is an agent skill for protocol accounts, channels, settlement, and BLS caveats.\n- `skills/ryvo-gateway-payment-channels/` is an agent skill for gateway payment-channel authorization.\n- `llm.txt` and `llms.txt` are LLM-readable gateway docs for websites.\n\n## Quick Checks\n\n```bash\nnode cli/ryvo-gateway.js health\nnode cli/ryvo-gateway.js catalog --provider helius\nnode cli/ryvo-gateway.js auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1\nnode agent-wallet/ryvo-wallet.js setup --profile default\nnode protocol-cli/ryvo-protocol.js token show\nnode mcp/server.js\nnode protocol-mcp/server.js\n```\n\nThe CLI and MCP server use `RYVO_SIGNER_COMMAND` when configured. The bundled agent wallet is replaceable; external wallets can return headers or signatures through the same hook.\nThe protocol CLI and MCP server are read + prepare only; they do not sign or broadcast transactions.\n",
  "bytes": 9986,
  "sha": "deed40f23094ca02e009aa2321b72839d1e1930f67442a0de1122d1cd24c11e1",
  "repo_slug": "agonx402/agon-gateway-agentic",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_agonx402_agon_protocol_4a694b32/readme"
}