{
  "markdown": "# DRPC Agent Skills\n\n[![GitHub stars](https://img.shields.io/github/stars/drpcorg/drpc-agent-skills?style=social)](https://github.com/drpcorg/drpc-agent-skills)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Blockchains](https://img.shields.io/badge/blockchains-100%2B-blue)](https://drpc.org/chainlist)\n[![Networks](https://img.shields.io/badge/networks-200%2B-purple)](https://drpc.org/chainlist)\n[![Platforms](https://img.shields.io/badge/platforms-8-green)](#install)\n[![MCP Tools](https://img.shields.io/badge/MCP_tools-16-orange)](#mcp-tools)\n\nGive your AI coding agent access to 100+ blockchains over RPC. Works on first ask -- no restart, no config file editing. Agents with a wallet get an API key automatically via x402 -- no signup needed. Guided recipes, error handling, 200+ networks.\n\n**Why DRPC?** Your requests go through a decentralized gateway that routes across multiple providers. If one is down, another picks up. Responses are consensus-validated, so you don't get bad data from a single node.\n\n## What Can You Do?\n\nType a plain English prompt. The agent figures out which RPC calls to make.\n\n| Use Case | Example Prompt |\n|----------|---------------|\n| **DeFi Portfolio** | \"Get my wallet balance across Ethereum, Arbitrum, and Base\" |\n| **Gas Optimization** | \"Compare gas prices across all L2 networks right now\" |\n| **Transaction Tracking** | \"Check if transaction 0xabc... is confirmed on Optimism\" |\n| **Smart Contract Reading** | \"Read the totalSupply of USDC contract on Base\" |\n| **Whale Watching** | \"Get the last 10 transactions for this address on Ethereum\" |\n| **Cross-Chain Analysis** | \"Compare TVL-related contract data across Arbitrum, Base and Optimism\" |\n\n## Install\n\n**Works with:** Claude Code · Gemini CLI · Cursor · Codex · Pi Agent · Windsurf · Cline · OpenClaw\n\nIf your agent has a wallet, it gets an API key automatically via [x402](skills/drpc-rpc/x402-auto-key.md) -- no signup. Otherwise, get a free key at [drpc.org](https://drpc.org). Then install the skill for your platform:\n\n### Claude Code\n```bash\nclaude plugins marketplace add drpcorg/drpc-agent-skills\nclaude plugins install drpc-agent-skills\n```\n\n### Gemini CLI\n```bash\ngemini extensions install https://github.com/drpcorg/drpc-agent-skills\n```\n\n### Codex\n```bash\ngit clone https://github.com/drpcorg/drpc-agent-skills.git\nln -s $(pwd)/drpc-agent-skills/skills/drpc-rpc ~/.agents/skills/drpc-rpc\n```\n\n### Pi Agent\n\n```bash\npi install npm:pi-mcp-adapter\npi install https://github.com/drpcorg/drpc-agent-skills\n```\n\nPi-specific setup is bundled as a Pi extension and documented separately in [.pi/INSTALL.md](.pi/INSTALL.md).\n\n### Cursor\n```bash\ngit clone https://github.com/drpcorg/drpc-agent-skills.git\nln -s $(pwd)/drpc-agent-skills/skills/drpc-rpc .cursor/skills/drpc-rpc\n```\n\n### Windsurf\n```bash\ngit clone https://github.com/drpcorg/drpc-agent-skills.git\nln -s $(pwd)/drpc-agent-skills/skills/drpc-rpc .windsurf/skills/drpc-rpc\n```\n\n### Cline\n```bash\ngit clone https://github.com/drpcorg/drpc-agent-skills.git\nln -s $(pwd)/drpc-agent-skills/skills/drpc-rpc .cline/skills/drpc-rpc\n```\n\n### OpenClaw\n```bash\ngit clone https://github.com/drpcorg/drpc-agent-skills.git\nln -s $(pwd)/drpc-agent-skills/skills/drpc-rpc ~/.openclaw/skills/drpc-rpc\n```\n\n## How It Works\n\nAsk something like:\n\n> \"Get the ETH balance of vitalik.eth on Ethereum\"\n\n> \"Compare gas prices across all L2 networks\"\n\nThe agent reads the skill file, picks the right RPC method, calls DRPC, and gives you back the result. No boilerplate on your end.\n\n```text\nYou ask → Agent reads skill → Calls DRPC API → Returns blockchain data\n```\n\nThree modes, picked automatically:\n1. **First session:** acquires API key via x402 wallet signing (or asks you for one), executes request via direct HTTP (no restart needed), configures MCP for future sessions\n2. **Subsequent sessions:** uses native MCP tools (faster, integrated)\n3. **Error handling:** recognizes billing limits, rate limiting, and guides recovery\n\n## x402: Automatic API Key Acquisition\n\nThis skill implements the [x402 payment protocol](https://github.com/coinbase/x402) -- an open standard by Coinbase for machine-to-machine payments over HTTP. When a server returns `402 Payment Required`, the client knows exactly what to pay, signs the payment, and gets access. No accounts, no dashboards, no copy-pasting keys.\n\nOur implementation adds a free shortcut on top of the standard flow:\n\n```text\nAgent has wallet?\n  │\n  ├─ yes → SIWE sign-in (EIP-4361) ─── wallet already linked? ─── yes → API key (free, instant)\n  │                                                                 │\n  │                                                                 no\n  │                                                                 ↓\n  │                                       Pay 5 USDC (EIP-3009 signature, settled on Base)\n  │                                                                 ↓\n  │                                                          API key + tx receipt\n  │\n  └─ no  → Ask user for key (fallback to drpc.org free tier)\n```\n\n1. **SIWE check first** -- the agent signs a message proving wallet ownership. If that wallet is already tied to a DRPC account, the API key comes back immediately at no cost.\n2. **Payment only when needed** -- for new wallets, the agent signs an EIP-3009 `transferWithAuthorization` for USDC on Base. The server settles it on-chain and returns the key.\n3. **Graceful fallback** -- no wallet? The agent asks the user for a key the old-fashioned way.\n\nAll signatures are off-chain (no gas for the user). Settlement happens server-side.\n\nSee [x402-auto-key.md](skills/drpc-rpc/x402-auto-key.md) for the full protocol recipe with curl examples.\n\n## Skill Contents\n\n| File | Purpose |\n|------|---------|\n| [SKILL.md](skills/drpc-rpc/SKILL.md) | Entry point — detects transport, routes by query type |\n| [setup.md](skills/drpc-rpc/setup.md) | MCP configuration per platform |\n| [direct-http.md](skills/drpc-rpc/direct-http.md) | Direct HTTP calls for first session (no MCP needed) |\n| [client-selection.md](skills/drpc-rpc/client-selection.md) | Direct JSON-RPC client selection (`reth`, `geth`, `erigon`, etc.) |\n| [tools-reference.md](skills/drpc-rpc/tools-reference.md) | All 16 MCP tools with parameters |\n| [recipes-simple.md](skills/drpc-rpc/recipes-simple.md) | Single-network recipes |\n| [recipes-crosschain.md](skills/drpc-rpc/recipes-crosschain.md) | Cross-chain recipes |\n| [x402-auto-key.md](skills/drpc-rpc/x402-auto-key.md) | Auto-acquire API key via x402 (SIWE + EIP-3009) |\n| [errors.md](skills/drpc-rpc/errors.md) | Error codes, billing errors, recovery patterns |\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_networks` | All 200+ supported networks |\n| `list_methods` | RPC methods for a network |\n| `get_network_info` | Network details (chain ID, currency, explorers) |\n| `eth_getBalance` | Native token balance |\n| `eth_getBlockByNumber` | Block by number or tag |\n| `eth_getBlockByHash` | Block by hash |\n| `eth_getTransactionByHash` | Transaction details |\n| `eth_getTransactionReceipt` | Receipt with status and logs |\n| `eth_getLogs` | Event log queries |\n| `eth_call` | Read smart contracts |\n| `eth_gasPrice` | Current gas price |\n| `eth_estimateGas` | Gas estimation |\n| `eth_getCode` | Contract bytecode |\n| `eth_getTransactionCount` | Nonce for address |\n| `rpc_call` | Any JSON-RPC method |\n| `rpc_batch` | Batch multiple calls |\n\n## Supported Networks\n\nEthereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche, zkSync, Linea, Scroll, Mantle, Fantom, Gnosis, Celo, Moonbeam, Harmony, Aurora, Metis, Boba, Cronos, Klaytn, Solana, Bitcoin, NEAR, Cosmos, Starknet, and [many more](https://drpc.org/chainlist).\n\n## Contributing\n\nFound a bug? Missing a chain? Open an issue or send a PR.\n\nStars help with discoverability -- if this saved you time, consider leaving one.\n\n## License\n\nMIT\n",
  "bytes": 7974,
  "sha": "a0bb9ac6b92d4bca31bf3f912705963711ccb057c357c9a6fe1700690754db05",
  "repo_slug": "drpcorg/drpc-agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_drpcorg_drpc_agent_skills_fe8f718c/readme"
}