Overview
Build Web3 plugin helps AI coding agents plan, build, review, and prepare Web3 apps for production.
The plugin installs two components:
build-web3skill: guides app design, selects chains and stacks, generates starters, reviews existing projects, and fixes approved issues. It also includes Quicknode product references so the agent can use the correct methods, parameters, and schemas when needed.- Quicknode MCP server: manages Quicknode infrastructure such as endpoints, security, rate limits, logs, usage, and billing. Requires a Quicknode account.
If you only need the build, review, and security workflows, you can install the build-web3 skill on its own without the Quicknode MCP server.
Installation
- Plugin
- Skill Only
Installs the skill and the MCP server. Pick your client below.
- Claude Code
- Codex
- Cursor
- Other Clients
Add the marketplace, then install the plugin:
/plugin marketplace add quicknode/agent-plugins
/plugin install build-web3@quicknode-agent-plugins
Start a new session. Claude Code then loads the skill and registers the quicknode MCP server. The first MCP tool call opens the Quicknode OAuth flow in your browser.
Add the marketplace, then install the plugin:
codex plugin marketplace add https://github.com/quicknode/agent-plugins.git
codex plugin add build-web3@quicknode-agent-plugins
Verify the install:
codex plugin list
Start a new Codex thread. Codex then loads the skill and the MCP tools.
Cursor installs the MCP server and the skill separately.
MCP server: use the deeplink in the install guide, or add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"quicknode": {
"type": "http",
"url": "https://mcp.quicknode.com/mcp"
}
}
}
You do not need an auth block. The server uses OAuth 2.1 with Dynamic Client Registration. Cursor registers itself and opens the consent page on first connect.
Skill: install it with the skills CLI:
npx skills add quicknode/agent-plugins --skill build-web3
VS Code, Windsurf, and Zed use the same two steps. See the per-client install guides.
Other clients install the two parts separately.
Skill: install it with the skills CLI:
npx skills add quicknode/agent-plugins --skill build-web3
MCP server: point any MCP client at https://mcp.quicknode.com/mcp. See Quicknode MCP.
Installs the skill without the MCP server. One command covers every agent the skills CLI supports, including Claude Code and Codex:
npx skills add quicknode/agent-plugins --skill build-web3
The installer asks for project-level or global installation, and which agents to configure.
The skill runs locally. It needs no Quicknode account. You get the build, review, and security workflows, plus every product reference. You do not get the MCP tools that manage endpoints, usage, and billing.
What the Skill Covers
The skill loads a small router file first. It then reads only the reference it needs for the task. This keeps the agent's context small.
Build Guidance
These references describe the app shape and the decisions behind it, before any provider or product.
| Reference | Covers |
|---|---|
use-case-playbooks | Bots, trackers, prediction markets, indexers, and wallet-paid agents |
app-architectures | Frontend, backend worker, indexer, and data pipeline shapes |
chains-and-stacks | EVM, Solana, and Hyperliquid, and the starter stack for each |
starter-patterns | Minimal starter layout, entry point, and environment placeholders |
data-and-infra | RPC, real-time events, historical data, storage, analytics, and payments |
security-and-production | Endpoint exposure, security controls, and environment separation |
quicknode-provider | How to map app capabilities to Quicknode |
quicknode-products | The product catalog and which product fits which need |
agent-access-and-automation | Keyless agent access and account automation |
addons | Add-ons that replace custom infrastructure |
Quicknode Product References
Each reference gives method tables, setup code, schemas, and a link to the matching page in these docs.
| Category | Products |
|---|---|
| Infrastructure | Core RPC API, IPFS |
| Real-Time Data | Streams, Streams Backfills, Webhooks, Solana gRPC, HyperCore gRPC / Hyperliquid |
| Indexed Data | SQL Explorer, Agent Identity (ERC-8004), Blockbook, Metaplex DAS API, Ordinals & Runes API |
| Trading & DeFi | Swap API |
| Platform | Admin API, Key-Value Store, Quicknode SDK |
| Agent Surface | x402, MPP, Agent Subscriptions, Quicknode CLI, Quicknode MCP |
Example Prompts
Build:
Help me plan a minimal Web3 app.
Build a TypeScript script that streams USDC transfers on Base into Postgres.
Improve:
Help me harden my Web3 app for mainnet.
Audit this repo for exposed endpoint URLs and committed secrets.
Manage infrastructure (MCP):
Create a Base mainnet endpoint and add a rate limit of 100 requests per second.
Query products:
Write a SQL Explorer query that returns the top 20 Hyperliquid traders by volume this week.
The agent uses testnet when you do not name a network. It never asks for private keys. It asks you to confirm before it sends transactions, spends funds, or changes endpoint security.
The skill loads on its own for a build or security task. For a product question, name the skill in your prompt: "use the build-web3 skill to write a Streams filter for USDC transfers on Base".