Quickstart

RPCX Quickstart: Custom Solana RPC Methods

Have your AI agent write a custom Solana RPC method over live Solana data with the RPCX MCP server, then save it, run it, and call it as rpcx_<name>.

RPCX lets you write your own read-only methods over live Solana data and call them as JSON-RPC methods. A method reads the latest Solana data, up to the newest blocks: transactions, instructions, logs, SOL and token balance changes, blocks, and the current state of accounts and token holdings, for many addresses at once, and returns the answer in one request. See Live tables. This page takes you from an empty RPCX page to a saved method you can call.

Before you start

You need an active Pro, Ultra, Max, or Enterprise plan, and a workspace role that can manage resources. Validating a method is free. Running one is billed in compute units (CU), at $1 per 1,000 CU. Each paid plan includes a monthly RPCX allowance, from 20,000 CU ($20) on Pro to 100,000 CU ($100) on Enterprise. Beyond it, you buy CU on the RPCX page; usage never charges your wallet. See Plan allowance and bought CU.

  1. Open the RPCX page

    Sign in to the dashboard and open the RPCX page. The Compute units panel at the top shows the CU you have: your plan's allowance for this month and any CU you bought.

  2. Generate an MCP key

    In Use with an AI agent, select Generate key. Copy the key now. It is shown once.

  3. Add the key to your coding agent

    The page shows a ready command for Claude Code. Run it in your terminal.

  4. Ask for a method

    Describe the data you want. The agent reads the tables, the rules, and the method language from the MCP server, validates its method, and ends its answer with the method text to paste.

  5. Paste, save, run

    In the RPCX page, select New Method and paste the text into the Code tab. The name and params fill in. Enter test values in Params, select Save, then Run.

Connect Claude Code

claude mcp add --transport http rpcx https://rpcx.mainnet.solana.nolimitnodes.com/mcp \  --header "Authorization: Bearer rpcx_mcp_YOUR_KEY"

Copy the exact command from the RPCX page. It already contains your key. For other MCP clients, see RPCX MCP server.

Ask the agent

A prompt like this is enough:

Using the rpcx MCP, write a method that returns every transaction of alist of wallets in a time window, newest first. Wallets and window as params.

The agent answers with a method like this one:

RPCX methodtext
method txsFor(wallets: pubkey[] "Accounts", from: time, to: time) {  from live_transactions  filter (address | in wallets) && ts >= from && ts < to  sort {-ts}}

The first line is the header: the method name and its params. wallets: pubkey[] is a list of addresses, so one call reads many wallets. The rest is the pipeline: start from a table, keep the rows of your wallets in the window, and sort them newest first. See Writing methods.

To write methods yourself, without an agent, use the Method language reference. It lists every step and function, with examples you can paste.

Save and run it

  1. In the RPCX page, select New Method.
  2. Paste the whole method into the Code tab. The name txsFor and the params wallets, from, and to fill in by themselves.
  3. Open Params and enter test values. For wallets, enter one address per line. For from and to, use a short recent range, for example the last hour.
  4. Select Validate to check the method. It is free and runs nothing.
  5. Select Save. The method is now callable as rpcx_txsFor. Run needs a saved method: after you change the code, save again before you run it.
  6. Select Run. The dashboard calls rpcx_txsFor with one of your workspace's API keys, the same way your app will. The response shows the rows, the cost in CU, and the time.

Each Run is billed for the bytes it read, at 1 CU per MiB and at least 1 CU. No estimate is shown before a run. Keep the time range short at first: a busy address in a long range reads a lot of data. See how CU is calculated.

Call it

curl https://rpcx.mainnet.solana.nolimitnodes.com \  -H "Content-Type: application/json" \  -H "x-api-key: $NLN_API_KEY" \  -d '{"jsonrpc":"2.0","id":1,"method":"rpcx_txsFor","params":{"wallets":["ARu4n5mFdZogZAravu7CcizaojWnS6oqka37gdLT5SZn","EKmzDJWkajsqLMkY5WLWts9iUgqHCQny6hhd77fcQGN"],"from":"2026-11-15T00:00:00Z","to":"2026-11-16T00:00:00Z"}}'

Use your NoLimitNodes API key, the same key as your RPC endpoint. Pass up to 1,000 wallets in one call. See Calling RPCX methods.

Next steps