@quicknode/mcp 0.0.1

package/dist/tools/usage.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUsageTools = setUsageTools;
+const generic_args_1 = require("../common/generic_args");
+const utils_1 = require("../common/utils");
+function setUsageTools(server, client) {
+    server.registerTool("get-rpc-usage", {
+        description: "Get the usage data for the user's QuickNode RPC account. The start_time and end_time parameters are ISO 8601 date strings to filter the usage data by time range",
+        inputSchema: { ...generic_args_1.genericArgs.timeRangeArgs },
+    }, async ({ start_time, end_time }) => {
+        const start_time_unix = (0, utils_1.isoToUnixTimestamp)(start_time);
+        const end_time_unix = (0, utils_1.isoToUnixTimestamp)(end_time);
+        if (!start_time_unix || !end_time_unix) {
+            throw new Error("Invalid time range, start_time and end_time must be valid ISO 8601 date strings");
+        }
+        const usage = await client.getRpcUsage({
+            start_time: start_time_unix,
+            end_time: end_time_unix,
+        });
+        const data = {
+            ...usage.data,
+            start_time: (0, utils_1.unixTimestampToIso)(usage.data.start_time),
+            end_time: (0, utils_1.unixTimestampToIso)(usage.data.end_time),
+        };
+        return {
+            structuredContent: { data },
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("get-rpc-usage-by-endpoint", {
+        description: "Get the usage data for the user's QuickNode RPC endpoints. The start_time and end_time parameters are ISO 8601 date strings to filter the usage data by time range",
+        inputSchema: { ...generic_args_1.genericArgs.timeRangeArgs },
+    }, async ({ start_time, end_time }) => {
+        const start_time_unix = (0, utils_1.isoToUnixTimestamp)(start_time);
+        const end_time_unix = (0, utils_1.isoToUnixTimestamp)(end_time);
+        if (!start_time_unix || !end_time_unix) {
+            throw new Error("Invalid time range, start_time and end_time must be valid ISO 8601 date strings");
+        }
+        const usage = await client.getRpcUsageByEndpoint({
+            start_time: start_time_unix,
+            end_time: end_time_unix,
+        });
+        const data = {
+            ...usage.data,
+            start_time: (0, utils_1.unixTimestampToIso)(usage.data.start_time),
+            end_time: (0, utils_1.unixTimestampToIso)(usage.data.end_time),
+        };
+        return {
+            structuredContent: { data },
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("get-rpc-usage-by-method", {
+        description: "Get the usage data for the user's QuickNode RPC endpoints, broken down by method. The start_time and end_time parameters are ISO 8601 date strings to filter the usage data by time range",
+        inputSchema: { ...generic_args_1.genericArgs.timeRangeArgs },
+    }, async ({ start_time, end_time }) => {
+        const start_time_unix = (0, utils_1.isoToUnixTimestamp)(start_time);
+        const end_time_unix = (0, utils_1.isoToUnixTimestamp)(end_time);
+        if (!start_time_unix || !end_time_unix) {
+            throw new Error("Invalid time range, start_time and end_time must be valid ISO 8601 date strings");
+        }
+        const usage = await client.getRpcUsageByMethod({
+            start_time: start_time_unix,
+            end_time: end_time_unix,
+        });
+        const data = {
+            ...usage.data,
+            start_time: (0, utils_1.unixTimestampToIso)(usage.data.start_time),
+            end_time: (0, utils_1.unixTimestampToIso)(usage.data.end_time),
+        };
+        return {
+            structuredContent: { data },
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("get-rpc-usage-by-chain", {
+        description: "Get the usage data for the user's QuickNode RPC endpoints, broken down by chain. The start_time and end_time parameters are ISO 8601 date strings to filter the usage data by time range",
+        inputSchema: { ...generic_args_1.genericArgs.timeRangeArgs },
+    }, async ({ start_time, end_time }) => {
+        const start_time_unix = (0, utils_1.isoToUnixTimestamp)(start_time);
+        const end_time_unix = (0, utils_1.isoToUnixTimestamp)(end_time);
+        if (!start_time_unix || !end_time_unix) {
+            throw new Error("Invalid time range, start_time and end_time must be valid ISO 8601 date strings");
+        }
+        const usage = await client.getRpcUsageByChain({
+            start_time: start_time_unix,
+            end_time: end_time_unix,
+        });
+        const data = {
+            ...usage.data,
+            start_time: (0, utils_1.unixTimestampToIso)(usage.data.start_time),
+            end_time: (0, utils_1.unixTimestampToIso)(usage.data.end_time),
+        };
+        return {
+            structuredContent: { data },
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@quicknode/mcp",
+  "version": "0.0.1",
+  "description": "MCP Server for building web3 infrastructure with QuickNode, leading Web3 infrastructure provider",
+  "author": "QuickNode <devex@quicknode.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quiknode-labs/qn-mcp.git"
+  },
+  "homepage": "https://github.com/quiknode-labs/qn-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/quiknode-labs/qn-mcp/issues"
+  },
+  "bin": {
+    "qn-mcp": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "format": "prettier --write .",
+    "format-test": "prettier --check .",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.13.2",
+    "express": "^5.1.0",
+    "zod": "^3.25.67",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.15.33",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "shx": "^0.4.0",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "web3",
+    "ai",
+    "mcp",
+    "model-context-protocol",
+    "quicknode",
+    "blockchain",
+    "infrastructure",
+    "api",
+    "endpoints",
+    "security",
+    "monitoring",
+    "management",
+    "provisioning",
+    "scaling",
+    "performance",
+    "claude",
+    "cursor",
+    "assistant"
+  ],
+  "license": "ISC"
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "outDir": "./dist",
+    "moduleResolution": "NodeNext",
+    "module": "NodeNext",
+    "isolatedModules": true
+  },
+  "include": ["./**/*.ts"],
+  "exclude": ["node_modules"]
+}