How to Use the BlockPi (Distributed RPC Network) MCP in Windsurf

Q: How do I install the BlockPi (Distributed RPC Network) MCP server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Cascade automatically reads the new tools once you hit refresh in the sidebar.

Q: Can Cascade automatically run blockchain queries using BlockPi (Distributed RPC Network)?

Yes, Cascade uses the rpccall tool to send JSON-RPC payloads to any supported network. You just tell the agent what data you need, and it handles the payload formatting and execution.

Q: How do I track my remaining RPC budget using BlockPi (Distributed RPC Network) in Windsurf?

Cascade executes getrubalance via the MCP server to check your account status. It prints the exact USD and RU balances right in your chat window.

Run raw blockchain queries and track your node consumption directly inside Windsurf using Cascade's autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BlockPi (Distributed RPC Network) MCP to Windsurf

Create your Vinkius account to connect BlockPi (Distributed RPC Network) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BlockPi (Distributed RPC Network) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Execute raw JSON-RPC calls on-chain

`rpc_call` lets Windsurf run raw blockchain queries like eth_getBalance or eth_blockNumber directly inside your workspace. Cascade takes your prompt, identifies the target network, and executes the call without you writing boilerplate script files. You get the exact hexadecimal or parsed output returned by the BlockPi node instantly. This lets your agent debug smart contract states or check block heights while you focus on writing your application logic.

Keep tabs on your Request Units inside Windsurf

`get_ru_balance` fetches your remaining Request Units directly into Cascade so you never run dry mid-test. The agent uses this data alongside `get_ru_consumed` to map out which specific endpoints are burning through your budget. If consumption spikes, Cascade flags the exact RPC endpoint causing the leak. You can then adjust your polling intervals before you burn through your entire testing budget.

Prevent runtime errors with active MCP Server package tracking

`get_package_expiration` retrieves the exact timestamp when your active RU packages expire. Cascade pulls this info to warn you about upcoming service disruptions before you deploy your Web3 code. Combining this with `get_wallet_balance` gives your agent a complete view of your billing health. It checks your USD balance and warns you if you need to top up your account to keep your endpoints active.

Setup guide

Set up BlockPi (Distributed RPC Network) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the BlockPi (Distributed RPC Network) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my BlockPi (Distributed RPC Network) payment history." If connected, Cascade will call the BlockPi (Distributed RPC Network) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "blockpi-distributed-rpc-network-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BlockPi. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BlockPi (Distributed RPC Network) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BlockPi (Distributed RPC Network) MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Cascade automatically reads the new tools once you hit refresh in the sidebar.

Yes, Cascade uses the `rpc_call` tool to send JSON-RPC payloads to any supported network. You just tell the agent what data you need, and it handles the payload formatting and execution.

Cascade executes `get_ru_balance` via the MCP server to check your account status. It prints the exact USD and RU balances right in your chat window.

You can query any EVM-compatible network or supported chain that your BlockPi account has access to. Just specify the network parameter when you ask Cascade to make the call.

All API keys and RPC payload data stay inside the secure Vinkius sandboxed environment. Your private keys never touch public logs, and the MCP server only routes authorized requests to the BlockPi network.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript