Connect AI agents to the Quicknode MCP server

Vendor MCP

The Quicknode MCP connector routes your AI agent's tool calls to Quicknode's own MCP server through Scalekit. Each user signs in to Quicknode once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 19 tools.

Tools: 19
What they doRead · write · destructive: 10 · 6 · 310 read6 write3 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
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>
```
Create the Quicknode MCP connection
In AgentKit > Connections, create a Quicknode MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Quicknode MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'quicknodemcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Quicknode MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'quicknodemcp_list-chains',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "quicknodemcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Quicknode MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="quicknodemcp_list-chains",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

quicknodemcp_get-billingRetrieve billing data (invoices or payments) for the user's QuickNode account.Read-only
Get Billing
Retrieve billing data (invoices or payments) for the user's QuickNode account.
Inputs
typestringrequired
The type of billing data to retrieve: "invoices" or "payments"one of invoicespayments
quicknodemcp_get-endpointRetrieve details for a specific QuickNode endpoint by ID.Read-only
Get Endpoint
Retrieve details for a specific QuickNode endpoint by ID.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
quicknodemcp_get-endpoint-log-detailsRetrieve the full request payload and response for a specific endpoint log entry.Read-only
Get Endpoint Log Details
Retrieve the full request payload and response for a specific endpoint log entry.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
request_idstringrequired
The UUID of the log entry to get detailed information for
quicknodemcp_get-endpoint-metricsRetrieve performance metrics (method calls, response status, latency) for a QuickNode endpoint over a given period.Read-only
Get Endpoint Metrics
Retrieve performance metrics (method calls, response status, latency) for a QuickNode endpoint over a given period.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
metricstringrequired
The type of metric to retrieveone of method_calls_over_timeresponse_status_over_timeresponse_status_breakdownmethod_response_time_max
periodstringrequired
The time period for which the data is to be retrievedone of hourdayweekmonth
percentileinteger
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-usageRetrieve RPC usage data for the account, optionally broken down by endpoint, method, or chain.Read-only
Get Rpc Usage
Retrieve RPC usage data for the account, optionally broken down by endpoint, method, or chain.
Inputs
end_timestringrequired
The end time of the time range (ISO 8601 format)
start_timestringrequired
The start time of the time range (ISO 8601 format)
breakdown_bystring
How to break down usage data: "none" for aggregate, "endpoint" by endpoint, "method" by RPC method, "chain" by chainone of noneendpointmethodchaindefault none
quicknodemcp_list-chainsList all blockchains and networks supported by QuickNode.Read-only
List Chains
List all blockchains and networks supported by QuickNode.
Inputs
This tool takes no inputs.
quicknodemcp_list-endpoint-logsList request and response logs for a QuickNode endpoint within a time range.Read-only
List Endpoint Logs
List request and response logs for a QuickNode endpoint within a time range.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
fromstringrequired
The start timestamp for logs (ISO 8601 format)
tostringrequired
The end timestamp for logs (ISO 8601 format)
include_detailsboolean
Include request/response details in logsdefault false
limitnumber
Number of logs to retrieve (1-100, default: 20)default 20
next_atstring
Pagination token from previous response
quicknodemcp_list-endpoint-method-rate-limitsList all method-specific rate limits configured for a QuickNode endpoint.Read-only
List Endpoint Method Rate Limits
List all method-specific rate limits configured for a QuickNode endpoint.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
quicknodemcp_list-endpoint-securityList all security options and rules configured for a QuickNode endpoint.Read-only
List Endpoint Security
List all security options and rules configured for a QuickNode endpoint.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
quicknodemcp_list-endpointsList all web3 RPC endpoints in the user's QuickNode account with optional pagination.Read-only
List Endpoints
List all web3 RPC endpoints in the user's QuickNode account with optional pagination.
Inputs
limitnumber
Number of endpoints to retrieve (1-250, default: 50)default 50
offsetnumber
Number of endpoints to skip for pagination (default: 0)default 0
quicknodemcp_create-endpointCreate a new web3 RPC endpoint for a given blockchain and network under the user's QuickNode account.Write
Create Endpoint
Create a new web3 RPC endpoint for a given blockchain and network under the user's QuickNode account.
Inputs
chainstringrequired
The blockchain chain (e.g., 'ethereum', 'polygon', 'arbitrum')
networkstringrequired
The specific network within the chain (e.g., 'mainnet', 'testnet')
quicknodemcp_create-endpoint-method-rate-limitCreate a method-specific rate limit for a QuickNode endpoint, restricting how often specific RPC methods can be called.Write
Create Endpoint Method Rate Limit
Create a method-specific rate limit for a QuickNode endpoint, restricting how often specific RPC methods can be called.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
intervalstringrequired
The time interval for the rate limitone of secondminutehour
methodsarrayrequired
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.
ratenumberrequired
Maximum number of requests allowed within the specified interval
quicknodemcp_create-security-ruleCreate a security rule (IP allowlist, JWT, referrer, domain mask, or token) for a QuickNode endpoint.Write
Create Security Rule
Create a security rule (IP allowlist, JWT, referrer, domain mask, or token) for a QuickNode endpoint.
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
typestringrequired
The type of security ruleone of ipjwtreferrerdomain_masktoken
domain_maskstring
The domain mask (required when type is "domain_mask")
ipstring
The IP address (required when type is "ip")
kidstring
The key identifier for JWT (required when type is "jwt")
namestring
A human-readable name for the JWT config (required when type is "jwt")
public_keystring
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.
referrerstring
The allowed referrer URL (required when type is "referrer")
tokenstring
The authentication token (required when type is "token")
quicknodemcp_update-endpoint-method-rate-limitUpdate the rate, interval, or status of an existing method-specific rate limit on a QuickNode endpoint.Write
Update Endpoint Method Rate Limit
Update the rate, interval, or status of an existing method-specific rate limit on a QuickNode endpoint.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
method_rate_limit_idstringrequired
The unique identifier for the rate limiter
methodsarrayrequired
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.
ratenumberrequired
Maximum number of requests allowed within the specified interval
statusstringrequired
If the rate limiter should be enabled or disabledone of enableddisabled
quicknodemcp_update-endpoint-rate-limitsUpdate the general rate limits (requests per second, minute, or day) for a QuickNode endpoint.Write
Update Endpoint Rate Limits
Update the general rate limits (requests per second, minute, or day) for a QuickNode endpoint.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
rpdinteger
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.
rpminteger
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.
rpsinteger
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-optionsUpdate security settings (CORS, HSTS, IP allowlists, JWT, tokens, referrers, domain masks) for a QuickNode endpoint.Write
Update Endpoint Security Options
Update security settings (CORS, HSTS, IP allowlists, JWT, tokens, referrers, domain masks) for a QuickNode endpoint.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
corsstring
Configures Cross-Origin Resource Sharing (CORS) policies to control how resources can be accessed by external domainsone of enableddisabled
domainMasksstring
Configures the masking or restriction of specific domainsone of enableddisabled
hstsstring
The HTTP Strict Transport Security (HSTS)one of enableddisabled
ipsstring
Specifies IP address-based restrictions or permissionsone of enableddisabled
jwtsstring
Configures JSON Web Tokens (JWTs) for secure authentication and authorizationone of enableddisabled
referrersstring
The URL or domain that is allowed to access the specific API endpointone of enableddisabled
tokensstring
Controls the token-based authentication mechanismone of enableddisabled
quicknodemcp_delete-endpointArchive a QuickNode endpoint by ID, making it inactive.Destructive
Delete Endpoint
Archive a QuickNode endpoint by ID, making it inactive.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
quicknodemcp_delete-endpoint-method-rate-limitPermanently delete a method-specific rate limit from a QuickNode endpoint.Destructive
Delete Endpoint Method Rate Limit
Permanently delete a method-specific rate limit from a QuickNode endpoint.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
method_rate_limit_idstringrequired
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-rulePermanently delete a security rule from a QuickNode endpoint.Destructive
Delete Security Rule
Permanently delete a security rule from a QuickNode endpoint.
- Idempotent
Inputs
endpoint_idstringrequired
The unique identifier of the Quicknode endpoint
rule_idstringrequired
The unique identifier of the security rule to delete
typestringrequired
The type of security ruleone of ipjwtreferrerdomain_masktoken

Setup

Install the SDK

Set your credentials

Create the Quicknode MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Get Billing

Inputs

Get Endpoint

Inputs

Get Endpoint Log Details

Inputs

Get Endpoint Metrics

Inputs

Get Rpc Usage

Inputs

List Chains

Inputs

List Endpoint Logs

Inputs

List Endpoint Method Rate Limits

Inputs

List Endpoint Security

Inputs

List Endpoints

Inputs

Create Endpoint

Inputs

Create Endpoint Method Rate Limit

Inputs

Create Security Rule

Inputs

Update Endpoint Method Rate Limit

Inputs

Update Endpoint Rate Limits

Inputs

Update Endpoint Security Options

Inputs

Delete Endpoint

Inputs

Delete Endpoint Method Rate Limit

Inputs

Delete Security Rule

Inputs

Related: other Developer Tools connectors