Quicknode MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'quicknodemcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Quicknode MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'quicknodemcp_list-chains',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "quicknodemcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Quicknode MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="quicknodemcp_list-chains",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update-endpoint-security-options records — Update security settings (CORS, HSTS, IP allowlists, JWT, tokens, referrers, domain masks) for a QuickNode endpoint
• Update-endpoint-rate-limits records — Update the general rate limits (requests per second, minute, or day) for a QuickNode endpoint
• Update-endpoint-method-rate-limit records — Update the rate, interval, or status of an existing method-specific rate limit on a QuickNode endpoint
• List-endpoints records — List all web3 RPC endpoints in the user’s QuickNode account with optional pagination
• List-endpoint-security records — List all security options and rules configured for a QuickNode endpoint
• List-endpoint-method-rate-limits records — List all method-specific rate limits configured for a QuickNode endpoint

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

quicknodemcp_create-endpoint # Create a new web3 RPC endpoint for a given blockchain and network under the user's QuickNode account. 2 params ▾

Create a new web3 RPC endpoint for a given blockchain and network under the user's QuickNode account.

Name Type Required Description

chain string required The blockchain chain (e.g., 'ethereum', 'polygon', 'arbitrum')

network string required The specific network within the chain (e.g., 'mainnet', 'testnet')

quicknodemcp_create-endpoint-method-rate-limit # Create a method-specific rate limit for a QuickNode endpoint, restricting how often specific RPC methods can be called. 4 params ▾

Create a method-specific rate limit for a QuickNode endpoint, restricting how often specific RPC methods can be called.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

interval string required The time interval for the rate limit

methods array required Array of method names to apply the rate limit to. NOTE: method matching is case-insensitive. Method names are lowercased server-side and compared against the lowercased limiter (e.g. a limiter on "eth_getBalance" is stored as "eth_getbalance" and matches incoming "eth_getBalance" traffic). The case you use when entering method names has no effect.

rate number required Maximum number of requests allowed within the specified interval

quicknodemcp_create-security-rule # Create a security rule (IP allowlist, JWT, referrer, domain mask, or token) for a QuickNode endpoint. 9 params ▾

Create a security rule (IP allowlist, JWT, referrer, domain mask, or token) for a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

type string required The type of security rule

domain_mask string optional The domain mask (required when type is "domain_mask")

ip string optional The IP address (required when type is "ip")

kid string optional The key identifier for JWT (required when type is "jwt")

name string optional A human-readable name for the JWT config (required when type is "jwt")

public_key string optional The public key for JWT verification (required when type is "jwt"). Must be a PEM-encoded RSA or EC public key with matching "-----BEGIN [RSA |EC ]PUBLIC KEY-----" / "-----END …-----" headers; malformed keys are rejected before the upstream call.

referrer string optional The allowed referrer URL (required when type is "referrer")

token string optional The authentication token (required when type is "token")

quicknodemcp_delete-endpoint # Archive a QuickNode endpoint by ID, making it inactive. 1 param ▾

Archive a QuickNode endpoint by ID, making it inactive.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

quicknodemcp_delete-endpoint-method-rate-limit # Permanently delete a method-specific rate limit from a QuickNode endpoint. 2 params ▾

Permanently delete a method-specific rate limit from a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

method_rate_limit_id string required The unique identifier of the rate limiter to delete. This can be found in the output of the list-endpoint-method-rate-limits tool

quicknodemcp_delete-security-rule # Permanently delete a security rule from a QuickNode endpoint. 3 params ▾

Permanently delete a security rule from a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

rule_id string required The unique identifier of the security rule to delete

type string required The type of security rule

quicknodemcp_get-billing # Retrieve billing data (invoices or payments) for the user's QuickNode account. 1 param ▾

Retrieve billing data (invoices or payments) for the user's QuickNode account.

Name Type Required Description

type string required The type of billing data to retrieve: "invoices" or "payments"

quicknodemcp_get-endpoint # Retrieve details for a specific QuickNode endpoint by ID. 1 param ▾

Retrieve details for a specific QuickNode endpoint by ID.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

quicknodemcp_get-endpoint-log-details # Retrieve the full request payload and response for a specific endpoint log entry. 2 params ▾

Retrieve the full request payload and response for a specific endpoint log entry.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

request_id string required The UUID of the log entry to get detailed information for

quicknodemcp_get-endpoint-metrics # Retrieve performance metrics (method calls, response status, latency) for a QuickNode endpoint over a given period. 4 params ▾

Retrieve performance metrics (method calls, response status, latency) for a QuickNode endpoint over a given period.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

metric string required The type of metric to retrieve

period string required The time period for which the data is to be retrieved

percentile integer optional Percentile (1-100) for response-time metrics. REQUIRED when metric is "method_response_time_max" (e.g. 50, 95, 99); ignored for other metrics

quicknodemcp_get-rpc-usage # Retrieve RPC usage data for the account, optionally broken down by endpoint, method, or chain. 3 params ▾

Retrieve RPC usage data for the account, optionally broken down by endpoint, method, or chain.

Name Type Required Description

end_time string required The end time of the time range (ISO 8601 format)

start_time string required The start time of the time range (ISO 8601 format)

breakdown_by string optional How to break down usage data: "none" for aggregate, "endpoint" by endpoint, "method" by RPC method, "chain" by chain

quicknodemcp_list-chains # List all blockchains and networks supported by QuickNode. 0 params ▾

List all blockchains and networks supported by QuickNode.

quicknodemcp_list-endpoint-logs # List request and response logs for a QuickNode endpoint within a time range. 6 params ▾

List request and response logs for a QuickNode endpoint within a time range.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

from string required The start timestamp for logs (ISO 8601 format)

to string required The end timestamp for logs (ISO 8601 format)

include_details boolean optional Include request/response details in logs

limit number optional Number of logs to retrieve (1-100, default: 20)

next_at string optional Pagination token from previous response

quicknodemcp_list-endpoint-method-rate-limits # List all method-specific rate limits configured for a QuickNode endpoint. 1 param ▾

List all method-specific rate limits configured for a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

quicknodemcp_list-endpoint-security # List all security options and rules configured for a QuickNode endpoint. 1 param ▾

List all security options and rules configured for a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

quicknodemcp_list-endpoints # List all web3 RPC endpoints in the user's QuickNode account with optional pagination. 2 params ▾

List all web3 RPC endpoints in the user's QuickNode account with optional pagination.

Name Type Required Description

limit number optional Number of endpoints to retrieve (1-250, default: 50)

offset number optional Number of endpoints to skip for pagination (default: 0)

quicknodemcp_update-endpoint-method-rate-limit # Update the rate, interval, or status of an existing method-specific rate limit on a QuickNode endpoint. 5 params ▾

Update the rate, interval, or status of an existing method-specific rate limit on a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

method_rate_limit_id string required The unique identifier for the rate limiter

methods array required Array of method names to apply the rate limit to. NOTE: method matching is case-insensitive. Method names are lowercased server-side and compared against the lowercased limiter (e.g. a limiter on "eth_getBalance" is stored as "eth_getbalance" and matches incoming "eth_getBalance" traffic). The case you use when entering method names has no effect.

rate number required Maximum number of requests allowed within the specified interval

status string required If the rate limiter should be enabled or disabled

quicknodemcp_update-endpoint-rate-limits # Update the general rate limits (requests per second, minute, or day) for a QuickNode endpoint. 4 params ▾

Update the general rate limits (requests per second, minute, or day) for a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

rpd integer optional Maximum requests per day. Pass -1 to remove an existing user override and fall back to the plan default; if no override exists, the bucket is skipped.

rpm integer optional Maximum requests per minute. Pass -1 to remove an existing user override and fall back to the plan default; if no override exists, the bucket is skipped.

rps integer optional Maximum requests per second. Pass -1 to remove an existing user override and fall back to the plan default; if no override exists, the bucket is skipped.

quicknodemcp_update-endpoint-security-options # Update security settings (CORS, HSTS, IP allowlists, JWT, tokens, referrers, domain masks) for a QuickNode endpoint. 8 params ▾

Update security settings (CORS, HSTS, IP allowlists, JWT, tokens, referrers, domain masks) for a QuickNode endpoint.

Name Type Required Description

endpoint_id string required The unique identifier of the Quicknode endpoint

cors string optional Configures Cross-Origin Resource Sharing (CORS) policies to control how resources can be accessed by external domains

domainMasks string optional Configures the masking or restriction of specific domains

hsts string optional The HTTP Strict Transport Security (HSTS)

ips string optional Specifies IP address-based restrictions or permissions

jwts string optional Configures JSON Web Tokens (JWTs) for secure authentication and authorization

referrers string optional The URL or domain that is allowed to access the specific API endpoint

tokens string optional Controls the token-based authentication mechanism