Skip to content

Commit a5ea1c2

Browse files
0xsergen0xsergen
committed
feat: fold quicknode-claude-plugin content into the quicknode plugin
Renames plugins/mcp -> plugins/quicknode and merges in the commands, rpc-troubleshooter subagent, and quicknode-skill (with its sync automation) from the standalone quicknode-claude-plugin repo, so Claude Code users get the full toolkit from one plugin install.
1 parent 2fe668a commit a5ea1c2

40 files changed

Lines changed: 9433 additions & 70 deletions

‎.claude-plugin/marketplace.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@
1111
},
1212
"plugins": [
1313
{
14-
"name": "mcp",
15-
"description": "Manage your blockchain infrastructure across 80+ chains with your agents.",
16-
"source": "./plugins/mcp",
14+
"name": "quicknode",
15+
"description": "Build on Quicknode blockchain infrastructure: manage endpoints across 80+ chains (MCP), plus commands, a subagent, and a skill for RPC, Solana, Hyperliquid, x402, MPP, and more.",
16+
"source": "./plugins/quicknode",
1717
"strict": false
1818
}
1919
]

‎.cursor-plugin/marketplace.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@
1111
},
1212
"plugins": [
1313
{
14-
"name": "mcp",
15-
"source": "./plugins/mcp",
14+
"name": "quicknode",
15+
"source": "./plugins/quicknode",
1616
"description": "Manage your blockchain infrastructure across 80+ chains with your agents."
1717
}
1818
]

‎.github/workflows/publish-mcp-registry.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,12 @@ jobs:
2222
- name: Sync version from tag to server.json
2323
run: |
2424
VERSION="${GITHUB_REF#refs/tags/v}"
25-
jq --arg v "$VERSION" '.version = $v' plugins/mcp/server.json > plugins/mcp/server.tmp.json
26-
mv plugins/mcp/server.tmp.json plugins/mcp/server.json
27-
cat plugins/mcp/server.json
25+
jq --arg v "$VERSION" '.version = $v' plugins/quicknode/server.json > plugins/quicknode/server.tmp.json
26+
mv plugins/quicknode/server.tmp.json plugins/quicknode/server.json
27+
cat plugins/quicknode/server.json
2828
2929
- name: Authenticate to MCP Registry via GitHub OIDC
3030
run: ./mcp-publisher login github-oidc
3131

3232
- name: Publish server to MCP Registry
33-
run: ./mcp-publisher publish plugins/mcp/server.json
33+
run: ./mcp-publisher publish plugins/quicknode/server.json

‎.github/workflows/sync-skill.yml‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
name: Sync quicknode-skill
2+
3+
on:
4+
schedule:
5+
- cron: '0 9 * * 1' # Every Monday 09:00 UTC
6+
workflow_dispatch:
7+
8+
permissions:
9+
contents: write
10+
pull-requests: write
11+
12+
jobs:
13+
sync:
14+
runs-on: ubuntu-latest
15+
16+
steps:
17+
- name: Checkout
18+
uses: actions/checkout@v4
19+
20+
- name: Run sync script
21+
id: sync
22+
env:
23+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
24+
run: |
25+
set +e
26+
bash scripts/sync-skill.sh
27+
EXIT=$?
28+
set -e
29+
if [ $EXIT -eq 1 ]; then
30+
echo "drift=true" >> "$GITHUB_OUTPUT"
31+
else
32+
echo "drift=false" >> "$GITHUB_OUTPUT"
33+
fi
34+
35+
- name: Read upstream SHA
36+
id: meta
37+
if: steps.sync.outputs.drift == 'true'
38+
run: |
39+
SHA=$(grep "Upstream commit:" plugins/quicknode/skills/quicknode-skill/SKILL_SOURCE.md | awk '{print $NF}')
40+
echo "sha=${SHA}" >> "$GITHUB_OUTPUT"
41+
42+
- name: Open PR on drift
43+
if: steps.sync.outputs.drift == 'true'
44+
uses: peter-evans/create-pull-request@v6
45+
with:
46+
token: ${{ secrets.GITHUB_TOKEN }}
47+
branch: sync/quicknode-skill-${{ steps.meta.outputs.sha }}
48+
delete-branch: true
49+
commit-message: "sync: update quicknode-skill from blockchain-skills@${{ steps.meta.outputs.sha }}"
50+
title: "Sync quicknode-skill from blockchain-skills@${{ steps.meta.outputs.sha }}"
51+
body: |
52+
Automated sync of `plugins/quicknode/skills/quicknode-skill/` from upstream [`quiknode-labs/blockchain-skills`](https://github.com/quiknode-labs/blockchain-skills).
53+
54+
**Upstream commit:** `${{ steps.meta.outputs.sha }}`
55+
56+
Review the diff to confirm no breaking changes before merging.
57+
labels: "sync,automated"
58+
reviewers: "0xsergen"

‎README.md‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ Agent plugins from Quicknode. MCP servers, skills, and more.
44

55
## Available plugins
66

7-
| Plugin | Description |
8-
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
9-
| [`mcp`](./plugins/mcp/) | Manage your blockchain infrastructure across 80+ chains with your agents. |
7+
| Plugin | Description |
8+
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
9+
| [`quicknode`](./plugins/quicknode/) | Build on Quicknode blockchain infrastructure: manage endpoints across 80+ chains (MCP), plus commands, a subagent, and a skill for RPC, Solana, Hyperliquid, x402, MPP, and more. |
1010

1111
## Install
1212

@@ -17,7 +17,13 @@ Agent plugins from Quicknode. MCP servers, skills, and more.
1717
| VS Code | [docs/install/vscode.md](./docs/install/vscode.md) |
1818
| Zed | [docs/install/zed.md](./docs/install/zed.md) |
1919

20-
For Claude Code and ChatGPT, use the existing listings on the respective marketplaces.
20+
For Claude Code, add this marketplace and install the `quicknode` plugin:
21+
22+
```
23+
/plugin marketplace add quicknode/agent-plugins
24+
```
25+
26+
For ChatGPT, use the existing listing on its marketplace.
2127

2228
## License
2329

‎docs/install/cursor.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ No `auth` block needed. The Quicknode MCP server uses OAuth 2.1 with **Dynamic C
3131

3232
## What you get
3333

34-
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.
34+
Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/quicknode/README.md) for capabilities.
3535

3636
## Troubleshooting
3737

‎docs/install/vscode.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ On first connection, VS Code performs OAuth 2.1 + Dynamic Client Registration ag
3737

3838
## What you get
3939

40-
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.
40+
Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/quicknode/README.md) for capabilities.
4141

4242
## Requirements
4343

‎docs/install/windsurf.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ windsurf://windsurf-mcp-registry?serverName=quicknode-mcp
3232
3333
## What you get
3434

35-
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.
35+
Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/quicknode/README.md) for capabilities.
3636

3737
## Requirements
3838

‎docs/install/zed.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Note: Zed uses `context_servers` (not `mcpServers`).
3939

4040
## What you get
4141

42-
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.
42+
Manage your blockchain infrastructure from your AI assistant: endpoints, rate limits, security, metrics, logs, and billing. See the [plugin README](../../plugins/quicknode/README.md) for capabilities.
4343

4444
## Requirements
4545

‎plugins/mcp/README.md‎

Lines changed: 0 additions & 49 deletions
This file was deleted.

0 commit comments

Comments
 (0)