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.

NameTypeRequiredDescription

chainstringrequiredThe blockchain chain (e.g., 'ethereum', 'polygon', 'arbitrum')

networkstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

intervalstringrequiredThe time interval for the rate limit

methodsarrayrequiredArray 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.

ratenumberrequiredMaximum 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

typestringrequiredThe type of security rule

domain_maskstringoptionalThe domain mask (required when type is "domain_mask")

ipstringoptionalThe IP address (required when type is "ip")

kidstringoptionalThe key identifier for JWT (required when type is "jwt")

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

public_keystringoptionalThe 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.

referrerstringoptionalThe allowed referrer URL (required when type is "referrer")

tokenstringoptionalThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

method_rate_limit_idstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

rule_idstringrequiredThe unique identifier of the security rule to delete

typestringrequiredThe 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.

NameTypeRequiredDescription

typestringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

request_idstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

metricstringrequiredThe type of metric to retrieve

periodstringrequiredThe time period for which the data is to be retrieved

percentileintegeroptionalPercentile (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.

NameTypeRequiredDescription

end_timestringrequiredThe end time of the time range (ISO 8601 format)

start_timestringrequiredThe start time of the time range (ISO 8601 format)

breakdown_bystringoptionalHow 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

fromstringrequiredThe start timestamp for logs (ISO 8601 format)

tostringrequiredThe end timestamp for logs (ISO 8601 format)

include_detailsbooleanoptionalInclude request/response details in logs

limitnumberoptionalNumber of logs to retrieve (1-100, default: 20)

next_atstringoptionalPagination 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe 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.

NameTypeRequiredDescription

limitnumberoptionalNumber of endpoints to retrieve (1-250, default: 50)

offsetnumberoptionalNumber 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

method_rate_limit_idstringrequiredThe unique identifier for the rate limiter

methodsarrayrequiredArray 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.

ratenumberrequiredMaximum number of requests allowed within the specified interval

statusstringrequiredIf 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

rpdintegeroptionalMaximum 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.

rpmintegeroptionalMaximum 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.

rpsintegeroptionalMaximum 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.

NameTypeRequiredDescription

endpoint_idstringrequiredThe unique identifier of the Quicknode endpoint

corsstringoptionalConfigures Cross-Origin Resource Sharing (CORS) policies to control how resources can be accessed by external domains

domainMasksstringoptionalConfigures the masking or restriction of specific domains

hstsstringoptionalThe HTTP Strict Transport Security (HSTS)

ipsstringoptionalSpecifies IP address-based restrictions or permissions

jwtsstringoptionalConfigures JSON Web Tokens (JWTs) for secure authentication and authorization

referrersstringoptionalThe URL or domain that is allowed to access the specific API endpoint

tokensstringoptionalControls the token-based authentication mechanism