Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,16 +5,16 @@
"url": "https://www.quicknode.com"
},
"metadata": {
"description": "Build on the best blockchain infrastructure with your agents.",
"description": "Build and harden 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 harden Web3 apps with your AI agent: choose a chain, architecture, stack, data layer, and production posture. Includes optional Quicknode infrastructure integration for managed RPC, streams, analytics, payments, and endpoint management.",
"source": "./plugins/build-web3",
"strict": false
}
]
}
}
10 changes: 5 additions & 5 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@
"email": "support@quicknode.com"
},
"metadata": {
"description": "Build on the best blockchain infrastructure with your agents.",
"description": "Build and harden 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 harden Web3 apps with your agents, with optional Quicknode MCP integration for managed blockchain infrastructure."
}
]
}
}
8 changes: 4 additions & 4 deletions .github/workflows/publish-mcp-registry.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
24 changes: 19 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -17,7 +17,21 @@ Agent plugins from Quicknode. MCP servers, skills, and more.
| VS Code | [docs/install/vscode.md](./docs/install/vscode.md) |
| Zed | [docs/install/zed.md](./docs/install/zed.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 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

Expand Down
4 changes: 2 additions & 2 deletions docs/install/cursor.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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).
4 changes: 2 additions & 2 deletions docs/install/vscode.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
4 changes: 2 additions & 2 deletions docs/install/windsurf.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
4 changes: 2 additions & 2 deletions docs/install/zed.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
12 changes: 12 additions & 0 deletions plugins/build-web3/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"name": "build-web3",
"description": "Build and harden Web3 apps with your AI agent: choose a chain, architecture, stack, data layer, and production posture. Includes optional Quicknode infrastructure integration for managed RPC, streams, analytics, payments, and endpoint management.",
"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"
}
Original file line number Diff line number Diff line change
@@ -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 harden Web3 apps with your agents, with optional Quicknode MCP integration for managed blockchain infrastructure.",
"author": {
"name": "Quicknode",
"email": "support@quicknode.com"
Expand Down
File renamed without changes.
59 changes: 59 additions & 0 deletions plugins/build-web3/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# 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**, 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 Claude Code 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 (Claude Code)

- **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
```

**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.
2 changes: 1 addition & 1 deletion plugins/mcp/server.json → plugins/build-web3/server.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"repository": {
"url": "https://github.com/quicknode/agent-plugins",
"source": "github",
"subfolder": "plugins/mcp"
"subfolder": "plugins/build-web3"
},
"remotes": [
{
Expand Down
Loading