docs: tool improvements

AlejandroFabianCampos · AlejandroFabianCampos · commit 6e8b4351e369 · 2026-06-01T13:22:09.000-03:00
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -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 70+ chains with your agents.",
       "source": "./plugins/mcp",
       "strict": false
     }
   ]
-}
+}
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
@@ -5,15 +5,15 @@
     "email": "support@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",
       "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 70+ chains with your agents."
     }
   ]
-}
+}
diff --git a/README.md b/README.md
@@ -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 70+ 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).
diff --git a/docs/install/cursor.md b/docs/install/cursor.md
@@ -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).
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
 
-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).
diff --git a/docs/install/windsurf.md b/docs/install/windsurf.md
@@ -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.
 
@@ -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.
diff --git a/docs/install/zed.md b/docs/install/zed.md
@@ -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
 {
@@ -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).
diff --git a/plugins/mcp/.cursor-plugin/plugin.json b/plugins/mcp/.cursor-plugin/plugin.json
@@ -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 70+ chains with your agents.",
   "author": {
     "name": "Quicknode",
     "email": "support@quicknode.com"
diff --git a/plugins/mcp/README.md b/plugins/mcp/README.md
@@ -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
 
@@ -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.
diff --git a/plugins/mcp/server.json b/plugins/mcp/server.json
@@ -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 70+ chains with your agents.",
   "version": "1.0.0",
   "repository": {
     "url": "https://github.com/quicknode/agent-plugins",
diff --git a/scripts/gen-install-links.mjs b/scripts/gen-install-links.mjs
@@ -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";

Original file line number	Diff line number	Diff line change
`@@ -5,15 +5,15 @@`
`5`	`5`	`"email": "support@quicknode.com"`
`6`	`6`	`},`
`7`	`7`	`"metadata": {`
`8`		`- "description": "AI agent plugins for Quicknode blockchain infrastructure — MCP servers, skills, and more.",`
	`8`	`+ "description": "Build on the best blockchain infrastructure with your agents.",`
`9`	`9`	`"version": "1.0.0",`
`10`	`10`	`"repository": "https://github.com/quicknode/agent-plugins"`
`11`	`11`	`},`
`12`	`12`	`"plugins": [`
`13`	`13`	`{`
`14`	`14`	`"name": "mcp",`
`15`	`15`	`"source": "./plugins/mcp",`
`16`		`- "description": "OAuth-secured remote MCP server for managing Quicknode infrastructure: endpoints, rate limits, security, metrics, billing."`
	`16`	`+ "description": "Manage your blockchain infrastructure across 70+ chains with your agents."`
`17`	`17`	`}`
`18`	`18`	`]`
`19`		`-}`
	`19`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",`
`3`	`3`	`"name": "io.github.quicknode/mcp",`
`4`		`- "description": "OAuth-secured remote MCP for managing Quicknode endpoints, rate limits, metrics, and billing.",`
	`4`	`+ "description": "Manage your blockchain infrastructure across 70+ chains with your agents.",`
`5`	`5`	`"version": "1.0.0",`
`6`	`6`	`"repository": {`
`7`	`7`	`"url": "https://github.com/quicknode/agent-plugins",`