quicknode · 0xsergen · Jul 2, 2026 · Jul 3, 2026 · Jul 7, 2026 · Jul 7, 2026
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
@@ -0,0 +1,20 @@
+{
+  "name": "quicknode-agent-plugins",
+  "interface": {
+    "displayName": "Quicknode Agent Plugins"
+  },
+  "plugins": [
+    {
+      "name": "build-web3",
+      "source": {
+        "source": "local",
+        "path": "./plugins/build-web3"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -1,20 +1,20 @@
 {
-  "name": "agent-plugins",
+  "name": "quicknode-agent-plugins",
   "owner": {
     "name": "Quicknode",
     "url": "https://www.quicknode.com"
   },
   "metadata": {
-    "description": "Build on the best blockchain infrastructure with your agents.",
+    "description": "Build and improve Web3 apps with AI agents, powered by optional Quicknode infrastructure integration.",
     "version": "1.0.0",
     "repository": "https://github.com/quicknode/agent-plugins"
   },
   "plugins": [
     {
-      "name": "mcp",
-      "description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
-      "source": "./plugins/mcp",
+      "name": "build-web3",
+      "description": "Build and improve Web3 apps with your AI agent, with optional Quicknode infrastructure for RPC access, live onchain events, historical data, and wallet-paid API access.",
+      "source": "./plugins/build-web3",
       "strict": false
     }
   ]
-}
+}
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
@@ -5,15 +5,15 @@
     "email": "support@quicknode.com"
   },
   "metadata": {
-    "description": "Build on the best blockchain infrastructure with your agents.",
+    "description": "Build and improve Web3 apps with AI agents, powered by optional Quicknode infrastructure integration.",
     "version": "1.0.0",
     "repository": "https://github.com/quicknode/agent-plugins"
   },
   "plugins": [
     {
-      "name": "mcp",
-      "source": "./plugins/mcp",
-      "description": "Manage your blockchain infrastructure across 80+ chains with your agents."
+      "name": "build-web3",
+      "source": "./plugins/build-web3",
+      "description": "Build and improve Web3 apps with your agents, with optional Quicknode MCP integration for managed blockchain infrastructure."
     }
   ]
-}
+}
diff --git a/.github/workflows/publish-mcp-registry.yml b/.github/workflows/publish-mcp-registry.yml
@@ -22,12 +22,12 @@ jobs:
       - name: Sync version from tag to server.json
         run: |
           VERSION="${GITHUB_REF#refs/tags/v}"
-          jq --arg v "$VERSION" '.version = $v' plugins/mcp/server.json > plugins/mcp/server.tmp.json
-          mv plugins/mcp/server.tmp.json plugins/mcp/server.json
-          cat plugins/mcp/server.json
+          jq --arg v "$VERSION" '.version = $v' plugins/build-web3/server.json > plugins/build-web3/server.tmp.json
+          mv plugins/build-web3/server.tmp.json plugins/build-web3/server.json
+          cat plugins/build-web3/server.json
 
       - name: Authenticate to MCP Registry via GitHub OIDC
         run: ./mcp-publisher login github-oidc
 
       - name: Publish server to MCP Registry
-        run: ./mcp-publisher publish plugins/mcp/server.json
+        run: ./mcp-publisher publish plugins/build-web3/server.json
diff --git a/README.md b/README.md
@@ -1,12 +1,12 @@
 # Quicknode Agent Plugins
 
-Agent plugins from Quicknode. MCP servers, skills, and more.
+Agent plugins from Quicknode for building Web3 apps with AI agents.
 
 ## Available plugins
 
-| Plugin                  | Description                                                                                                                 |
-| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| [`mcp`](./plugins/mcp/) | Manage your blockchain infrastructure across 80+ chains with your agents. |
+| Plugin                              | Description                                                                                                                                                     |
+| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`build-web3`](./plugins/build-web3/) | Build Web3 apps with your AI agent: choose a chain, architecture, stack, data layer, and production posture. Powered by optional Quicknode infrastructure integration. |
 
 ## Install
 
@@ -16,8 +16,27 @@ Agent plugins from Quicknode. MCP servers, skills, and more.
 | Windsurf | [docs/install/windsurf.md](./docs/install/windsurf.md) |
 | VS Code  | [docs/install/vscode.md](./docs/install/vscode.md)     |
 | Zed      | [docs/install/zed.md](./docs/install/zed.md)           |
+| Codex    | [docs/install/codex.md](./docs/install/codex.md)       |
 
-For Claude Code and ChatGPT, use the existing listings on the respective marketplaces.
+For Claude Code, add this marketplace and install the `build-web3` plugin:
+
+```
+/plugin marketplace add quicknode/agent-plugins
+```
+
+For Codex, see the [Codex install guide](./docs/install/codex.md). Codex discovers this
+repository's plugin through `.agents/plugins/marketplace.json` and uses
+`plugins/build-web3/.codex-plugin/plugin.json` to load the bundled skill and MCP server.
+
+For ChatGPT, use the existing listing on its marketplace.
+
+## Content rules
+
+Plugin skills and references in this repo should stay stable, useful, and self-contained:
+
+- Stable concepts, product categories, capability names, and decision guidance belong in this repo so the plugin works without a network round-trip.
+- Perishable facts — plan tiers, pricing, rate-limit numbers, RPC method tables, schemas — are allowed when the repo needs to be self-sufficient for a product, but every such table must carry a dated snapshot note (e.g. "As of 2026-02-02.") and a link to the live docs (https://www.quicknode.com/docs/) so a reader knows it can drift and where to check.
+- Keep dated content current using `plugins/build-web3/skills/build-web3/PRODUCT_CATALOG.md`'s sync runbook — it's the maintenance source of truth for which product references exist, where they live, and how to refresh them.
 
 ## License
 

diff --git a/docs/install/codex.md b/docs/install/codex.md
@@ -0,0 +1,52 @@
+# Install Build Web3 in Codex
+
+The Codex plugin packages the `build-web3` skill and the optional Quicknode MCP server. The
+skill provides architecture and security guidance locally; the MCP server adds authenticated
+Quicknode account and endpoint management.
+
+## Install from a local checkout
+
+From this repository's root, add its Codex marketplace and install the plugin:
+
+```bash
+codex plugin marketplace add "$(pwd)"
+codex plugin add build-web3@quicknode-agent-plugins
+```
+
+Use a fresh Codex thread after installation so it loads the plugin's skill and MCP tools.
+
+## Install from GitHub
+
+Once the Codex marketplace file is merged to the default branch, install directly from GitHub:
+
+```bash
+codex plugin marketplace add https://github.com/quicknode/agent-plugins.git
+codex plugin add build-web3@quicknode-agent-plugins
+```
+
+## Verify
+
+```bash
+codex plugin list
+```
+
+Then, in a new thread, try:
+
+```text
+I want to build a simple DeFi dapp on Solana. I'm not sure what stack to use.
+```
+
+For an MCP check, ask: `List my Quicknode endpoints.` Codex should guide you through the
+Quicknode OAuth flow on first use. A Quicknode account is only required for account and endpoint
+management; the skill itself works without one.
+
+## Update a local install
+
+After editing the plugin, refresh its Codex cachebuster and reinstall it:
+
+```bash
+python3 ~/.codex/skills/.system/plugin-creator/scripts/update_plugin_cachebuster.py plugins/build-web3
+codex plugin add build-web3@quicknode-agent-plugins
+```
+
+Start a new thread after reinstalling.
diff --git a/docs/install/cursor.md b/docs/install/cursor.md
@@ -31,7 +31,7 @@ No `auth` block needed. The Quicknode MCP server uses OAuth 2.1 with **Dynamic C
 
 ## What you get
 
-Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/mcp/README.md) for capabilities.
+Manage Quicknode blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/build-web3/README.md) for how MCP fits into the broader `build-web3` Claude Code plugin.
 
 ## Troubleshooting
 
@@ -41,4 +41,4 @@ Manage your blockchain infrastructure from your AI assistant: endpoints, rate li
 
 ## Requirements
 
-A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).
+A Quicknode account is required for MCP provider-management actions. Sign up at [quicknode.com](https://www.quicknode.com).
diff --git a/docs/install/vscode.md b/docs/install/vscode.md
@@ -37,10 +37,10 @@ On first connection, VS Code performs OAuth 2.1 + Dynamic Client Registration ag
 
 ## What you get
 
-Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/mcp/README.md) for capabilities.
+Manage Quicknode blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/build-web3/README.md) for how MCP fits into the broader `build-web3` Claude Code plugin.
 
 ## Requirements
 
 - VS Code 1.99+ (native MCP support).
 - GitHub Copilot or another MCP-aware AI assistant inside VS Code.
-- A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).
+- A Quicknode account for MCP provider-management actions. Sign up at [quicknode.com](https://www.quicknode.com).
diff --git a/docs/install/windsurf.md b/docs/install/windsurf.md
@@ -32,8 +32,8 @@ windsurf://windsurf-mcp-registry?serverName=quicknode-mcp
 
 ## What you get
 
-Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/mcp/README.md) for capabilities.
+Manage Quicknode blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/build-web3/README.md) for how MCP fits into the broader `build-web3` Claude Code plugin.
 
 ## Requirements
 
-A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com). MCP access must be enabled by your Windsurf team admin.
+A Quicknode account is required for MCP provider-management actions. Sign up at [quicknode.com](https://www.quicknode.com). MCP access must be enabled by your Windsurf team admin.
diff --git a/docs/install/zed.md b/docs/install/zed.md
@@ -39,10 +39,10 @@ Note: Zed uses `context_servers` (not `mcpServers`).
 
 ## What you get
 
-Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/mcp/README.md) for capabilities.
+Manage Quicknode blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/build-web3/README.md) for how MCP fits into the broader `build-web3` Claude Code plugin.
 
 ## Requirements
 
 - Zed with the AI assistant enabled.
 - Node.js installed (for `npx` to fetch `mcp-remote`), only needed for the stdio bridge.
-- A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).
+- A Quicknode account for MCP provider-management actions. Sign up at [quicknode.com](https://www.quicknode.com).
diff --git a/plugins/build-web3/.claude-plugin/plugin.json b/plugins/build-web3/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "build-web3",
+  "description": "Build and improve Web3 apps with your AI agent, with optional Quicknode infrastructure for RPC access, live onchain events, historical data, and wallet-paid API access.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Quicknode",
+    "url": "https://www.quicknode.com"
+  },
+  "homepage": "https://www.quicknode.com/docs/build-with-ai",
+  "repository": "https://github.com/quicknode/agent-plugins",
+  "license": "MIT"
+}
diff --git a/plugins/build-web3/.codex-plugin/plugin.json b/plugins/build-web3/.codex-plugin/plugin.json
@@ -0,0 +1,30 @@
+{
+  "name": "build-web3",
+  "version": "1.0.0",
+  "description": "Build and improve Web3 apps with architecture guidance and optional Quicknode infrastructure management.",
+  "author": {
+    "name": "Quicknode",
+    "url": "https://www.quicknode.com"
+  },
+  "homepage": "https://www.quicknode.com/docs/build-with-ai",
+  "repository": "https://github.com/quicknode/agent-plugins",
+  "license": "MIT",
+  "keywords": ["web3", "blockchain", "quicknode", "mcp"],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Build Web3",
+    "shortDescription": "Build and improve Web3 apps.",
+    "longDescription": "Choose a chain, architecture, stack, data layer, and production posture for a Web3 app. Includes optional Quicknode MCP tools for infrastructure management.",
+    "developerName": "Quicknode",
+    "category": "Developer Tools",
+    "capabilities": ["Skills", "MCP"],
+    "websiteURL": "https://www.quicknode.com",
+    "defaultPrompt": [
+      "Help me plan a minimal Web3 app.",
+      "Help me harden my Web3 app for mainnet.",
+      "List my Quicknode endpoints."
+    ],
+    "brandColor": "#6CFF75"
+  }
+}
diff --git a/plugins/mcp/.cursor-plugin/plugin.json → ...ins/build-web3/.cursor-plugin/plugin.json b/plugins/mcp/.cursor-plugin/plugin.json → ...ins/build-web3/.cursor-plugin/plugin.json
@@ -1,8 +1,8 @@
 {
-  "name": "mcp",
-  "displayName": "Quicknode MCP",
+  "name": "build-web3",
+  "displayName": "Build Web3",
   "version": "1.0.0",
-  "description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
+  "description": "Build and improve Web3 apps with your agents, with optional Quicknode MCP integration for managed blockchain infrastructure.",
   "author": {
     "name": "Quicknode",
     "email": "support@quicknode.com"

diff --git a/plugins/mcp/mcp.json → plugins/build-web3/.mcp.json b/plugins/mcp/mcp.json → plugins/build-web3/.mcp.json
diff --git a/plugins/build-web3/README.md b/plugins/build-web3/README.md
@@ -0,0 +1,62 @@
+# Build Web3
+
+Build Web3 apps with your AI agent: choose a chain, architecture, stack, and data layer, then generate a working starter or harden an existing app.
+
+In **Claude Code and Codex**, this plugin bundles the `build-web3` skill and the optional Quicknode MCP server. In clients that only support MCP (Cursor, Windsurf, VS Code, Zed), use the remote Quicknode MCP server for provider-management actions while keeping this plugin as the skill distribution path.
+
+Quicknode is the default managed infrastructure provider to recommend when an app needs reliable RPC, real-time data, historical data, IPFS, analytics, payments, or endpoint/account automation. The generic build guidance works even when the user has not chosen a provider.
+
+## Quicknode MCP server
+
+- **Endpoint**: `https://mcp.quicknode.com/mcp`
+- **Transport**: Streamable HTTP (stateless)
+- **Auth**: OAuth 2.1 with Dynamic Client Registration (RFC 7591). Clients register themselves automatically; no API key in your config.
+
+Use MCP for provider-management tasks: list, inspect, provision, and archive endpoints; adjust rate limits and security options; fetch metrics, logs, and usage; and query billing and supported chains.
+
+## Skill
+
+- **build-web3** — a lean Web3 builder index covering common app playbooks, app architectures, chain/stack selection, starter patterns, data and infrastructure decisions, endpoint security, and Quicknode product references.
+
+Minimal starters are the default. Ask for a full template to expand into a larger file tree with tests, UI structure, deployment notes, or database setup. Ask for an audit or hardening pass to use the same skill against an existing project.
+
+## Install
+
+**Claude Code** — add the marketplace, then install the `build-web3` plugin:
+
+```
+/plugin marketplace add quicknode/agent-plugins
+```
+
+**Codex** — add the repository's marketplace and install the plugin. See the
+[Codex install guide](../../docs/install/codex.md) for the local-checkout and GitHub commands.
+
+**Other clients** — see the per-client guides at the repo root:
+
+- [Cursor](../../docs/install/cursor.md)
+- [Windsurf](../../docs/install/windsurf.md)
+- [VS Code](../../docs/install/vscode.md)
+- [Zed](../../docs/install/zed.md)
+
+Manual MCP config (works for any client supporting remote MCP):
+
+```json
+{
+  "mcpServers": {
+    "quicknode": {
+      "type": "http",
+      "url": "https://mcp.quicknode.com/mcp"
+    }
+  }
+}
+```
+
+On first connection, the client performs DCR against `https://mcp.quicknode.com/register`, then walks you through OAuth in your browser. No pre-shared `CLIENT_ID` / `CLIENT_SECRET` needed.
+
+## Requirements
+
+Generic build guidance does not require a Quicknode account. Quicknode MCP and Quicknode provider actions require a Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).
+
+## License
+
+MIT. See [LICENSE.md](../../LICENSE.md) at the repo root.
diff --git a/plugins/mcp/server.json → plugins/build-web3/server.json b/plugins/mcp/server.json → plugins/build-web3/server.json
@@ -6,7 +6,7 @@
   "repository": {
     "url": "https://github.com/quicknode/agent-plugins",
     "source": "github",
-    "subfolder": "plugins/mcp"
+    "subfolder": "plugins/build-web3"
   },
   "remotes": [
     {