Skip to content

docs: tool improvements #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlejandroFabianCampos merged 1 commit into from
Jun 1, 2026
Merged

docs: tool improvements #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 3 additions & 3 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,16 +5,16 @@
"url": "https://www.quicknode.com"
},
"metadata": {
"description": "AI agent plugins for Quicknode blockchain infrastructure — MCP servers, skills, and more.",
"description": "Build on the best blockchain infrastructure with your agents.",
"version": "1.0.0",
"repository": "https://github.com/quicknode/agent-plugins"
},
"plugins": [
{
"name": "mcp",
"description": "OAuth-secured remote MCP server for managing Quicknode infrastructure: endpoints, rate limits, security, metrics, billing.",
"description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
"source": "./plugins/mcp",
"strict": false
}
]
}
}
6 changes: 3 additions & 3 deletions .cursor-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@
"email": "[email protected]"
},
"metadata": {
"description": "AI agent plugins for Quicknode blockchain infrastructure — MCP servers, skills, and more.",
"description": "Build on the best blockchain infrastructure with your agents.",
"version": "1.0.0",
"repository": "https://github.com/quicknode/agent-plugins"
},
"plugins": [
{
"name": "mcp",
"source": "./plugins/mcp",
"description": "OAuth-secured remote MCP server for managing Quicknode infrastructure: endpoints, rate limits, security, metrics, billing."
"description": "Manage your blockchain infrastructure across 80+ chains with your agents."
}
]
}
}
20 changes: 10 additions & 10 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# Quicknode Agent Plugins

Distribution surface for Quicknode's AI agent plugins — MCP servers, skills, prompts, and rules — across IDE marketplaces.
Agent plugins from Quicknode. MCP servers, skills, and more.

## Available plugins

| Plugin | Description |
|---|---|
| [`mcp`](./plugins/mcp/) | OAuth-secured remote MCP server for managing Quicknode infrastructure — endpoints, rate limits, security, metrics, billing. |
| Plugin | Description |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| [`mcp`](./plugins/mcp/) | Manage your blockchain infrastructure across 80+ chains with your agents. |

## Install

| Client | Guide |
|---|---|
| Cursor | [docs/install/cursor.md](./docs/install/cursor.md) |
| Client | Guide |
| -------- | ------------------------------------------------------ |
| Cursor | [docs/install/cursor.md](./docs/install/cursor.md) |
| 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) |
| 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.

## License

MIT — see [LICENSE.md](./LICENSE.md).
MIT. See [LICENSE.md](./LICENSE.md).
8 changes: 4 additions & 4 deletions docs/install/cursor.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,18 +27,18 @@ Edit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project) and add:
}
```

No `auth` block needed — the Quicknode MCP server uses OAuth 2.1 with **Dynamic Client Registration** (RFC 7591). Cursor will register itself automatically against `https://mcp.quicknode.com/register` and walk you through OAuth in your browser on first connect.
No `auth` block needed. The Quicknode MCP server uses OAuth 2.1 with **Dynamic Client Registration** (RFC 7591). Cursor will register itself automatically against `https://mcp.quicknode.com/register` and walk you through OAuth in your browser on first connect.

## What you get

Tools for managing Quicknode endpoints, rate limits, security rules, metrics, billing, RPC usage, and supported chains — all through natural language. See the [plugin README](../../plugins/mcp/README.md) for the full tool list.
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.

## Troubleshooting

- **First connection hangs**: confirm your browser opened the OAuth consent page. If your popup blocker swallowed it, copy the URL from Cursor's logs.
- **"Insufficient scope" errors**: try removing the server and re-adding it — the DCR client may have been registered with stale scopes.
- **"Insufficient scope" errors**: try removing the server and re-adding it. The DCR client may have been registered with stale scopes.
- **Cursor keeps re-registering**: known upstream issue ([cursor forum](https://forum.cursor.com/t/mcp-oauth-persist-dcr-client-id-across-reconnects-avoid-as-side-registration-spam/158226)). Doesn't affect functionality.

## Requirements

A Quicknode account — sign up at [quicknode.com](https://www.quicknode.com).
A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).
4 changes: 2 additions & 2 deletions docs/install/vscode.md
View file
Open in desktop
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

Tools for managing Quicknode endpoints, rate limits, security rules, metrics, billing, RPC usage, and supported chains. See the [plugin README](../../plugins/mcp/README.md) for the full tool list.
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.

## 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. Sign up at [quicknode.com](https://www.quicknode.com).
6 changes: 3 additions & 3 deletions docs/install/windsurf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Edit `~/.codeium/windsurf/mcp_config.json` and add:
}
```

Note: Windsurf uses `serverUrl` (not `url`). Then **fully quit and reopen Windsurf** — closing the window alone doesn't reload MCP servers.
Note: Windsurf uses `serverUrl` (not `url`). Then **fully quit and reopen Windsurf**. Closing the window alone doesn't reload MCP servers.

On first connection, Windsurf performs OAuth 2.1 + Dynamic Client Registration against `https://mcp.quicknode.com/register` and prompts you to authorize in the browser. No pre-shared credentials needed.

Expand All @@ -32,8 +32,8 @@ windsurf://windsurf-mcp-registry?serverName=quicknode-mcp

## What you get

Tools for managing Quicknode endpoints, rate limits, security rules, metrics, billing, RPC usage, and supported chains. See the [plugin README](../../plugins/mcp/README.md) for the full tool list.
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.

## 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. Sign up at [quicknode.com](https://www.quicknode.com). MCP access must be enabled by your Windsurf team admin.
8 changes: 4 additions & 4 deletions docs/install/zed.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ In Zed's settings (Command Palette → "zed: open settings"), add to `context_se

`mcp-remote` handles the OAuth + DCR handshake locally and proxies it over stdio into Zed.

## Native remote (try first if you want — may not work yet)
## Native remote

```json
{
Expand All @@ -39,10 +39,10 @@ Note: Zed uses `context_servers` (not `mcpServers`).

## What you get

Tools for managing Quicknode endpoints, rate limits, security rules, metrics, billing, RPC usage, and supported chains. See the [plugin README](../../plugins/mcp/README.md) for the full tool list.
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.

## 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).
- 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).
2 changes: 1 addition & 1 deletion plugins/mcp/.cursor-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "mcp",
"displayName": "Quicknode MCP",
"version": "1.0.0",
"description": "OAuth-secured remote MCP server for managing Quicknode blockchain infrastructure — endpoints, rate limits, security, metrics, billing.",
"description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
"author": {
"name": "Quicknode",
"email": "[email protected]"
Expand Down
37 changes: 12 additions & 25 deletions plugins/mcp/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Quicknode MCP

OAuth-secured remote MCP server for managing your Quicknode blockchain infrastructure from any MCP-compatible AI assistant.
Give your AI agents the best blockchain infrastructure.

- **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
- **Auth**: OAuth 2.1 with Dynamic Client Registration (RFC 7591). Clients register themselves automatically; no API key in your config.

## Install

Expand All @@ -30,33 +30,20 @@ Manual config (works for any client supporting remote 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.

## Available tools

| Tool | Purpose |
|---|---|
| `list-endpoints` | List your Quicknode endpoints |
| `get-endpoint` | Get details for one endpoint |
| `create-endpoint` | Provision a new endpoint |
| `delete-endpoint` | Decommission an endpoint |
| `update-endpoint-security-options` | Update endpoint security configuration |
| `update-endpoint-rate-limits` | Adjust per-method rate limits |
| `get-endpoint-rate-limit-by-method` | Inspect a single method's rate limit |
| `get-rate-limit-details` | Get rate-limit configuration details |
| `list-endpoint-method-rate-limits` | List all method-level limits for an endpoint |
| `create-security-rule` | Add a security rule |
| `delete-security-rule` | Remove a security rule |
| `list-endpoint-security` | List active security rules |
| `get-endpoint-metrics` | Fetch endpoint metrics |
| `list-endpoint-logs` | List endpoint request logs |
| `get-endpoint-log-details` | Inspect one log entry |
| `get-rpc-usage` | RPC usage stats |
| `get-billing` | Account billing summary |
| `list-chains` | List supported chains |
## What you can do

- **Endpoint management**: list, inspect, provision, and archive Quicknode endpoints across supported chains.
- **Rate limits**: adjust general (RPS/RPM/RPD) limits and configure per-method rate limiters.
- **Security**: manage endpoint security options (CORS, JWT, IPs, etc.) and rules (IP, JWT, referrer, domain mask, token).
- **Observability**: fetch endpoint metrics, request/response logs, and account-level RPC usage breakdowns.
- **Account**: query billing and discover supported chains.

Once connected, your MCP client will display the live tool list from the server.

## Requirements

A Quicknode account. Sign up at [quicknode.com](https://www.quicknode.com).

## License

MIT — see [LICENSE.md](../../LICENSE.md) at the repo root.
MIT. See [LICENSE.md](../../LICENSE.md) at the repo root.
2 changes: 1 addition & 1 deletion plugins/mcp/server.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "io.github.quicknode/mcp",
"description": "OAuth-secured remote MCP for managing Quicknode endpoints, rate limits, metrics, and billing.",
"description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
"version": "1.0.0",
"repository": {
"url": "https://github.com/quicknode/agent-plugins",
Expand Down
2 changes: 1 addition & 1 deletion scripts/gen-install-links.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env node
// Generates per-client install deeplinks from the plugin's mcp.json and
// rewrites them into docs/install/*.md between sentinel markers.
// Idempotent — safe to re-run.
// Idempotent. Safe to re-run.

import { readFileSync, writeFileSync } from "node:fs";
import { fileURLToPath } from "node:url";
Expand Down