How to Use the Nodereal MCP in Windsurf

Q: How do I configure Nodereal with Windsurf Cascade?

You edit your /.codeium/windsurf/mcpconfig.json file to add the server to your mcpServers list. Once saved, the MCP integration auto-discovers all 24 tools for immediate use.

Q: Can Windsurf use Nodereal to debug smart contracts?

Yes, Windsurf can call debugtracetransaction to pull full execution traces. Cascade parses the trace to pinpoint exactly why an EVM transaction failed in your local environment.

Fetch block data and simulate Aptos or EVM transactions on the fly while Windsurf Cascade chains your web3 development tasks using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nodereal MCP to Windsurf

Create your Vinkius account to connect Nodereal 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 Nodereal with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Simulate transactions in Windsurf Cascade

`aptos_simulate_transaction` lets your Cascade agent dry-run Move transactions before sending them to the mainnet. Windsurf reads your local smart contract code, builds the payload, and runs the simulation to check for gas usage or logic errors without writing boilerplate test scripts. You get the raw execution results directly in your IDE pane. Cascade uses this output to modify your frontend transaction builders automatically, saving you from manual ABI debugging loops.

Inspect EVM ledger state during active coding sessions

`eth_get_balance` and `eth_call` read live blockchain state directly from Nodereal high-performance nodes into your workspace. When you ask Cascade to verify a smart contract's read function, it queries the network instantly to verify returned variables against your local expectations. The agent uses these live values to write accurate unit tests. You don't need to copy-paste contract addresses or write mock providers because the MCP server feeds live chain data straight to your agent.

Retrieve deep token analytics instantly

`nr_get_token_holders` and `nr_get_nft_inventory` expose Nodereal's custom indexed data directly to your editor. Cascade can write a script to map out top holders or list user balances by chaining these queries together in a single prompt. This removes the need to write custom indexing scripts or parse raw logs manually. Your agent gets clean, structured JSON back, making it easy to generate dApp dashboards or audit token distributions on the spot.

Setup guide

Set up Nodereal 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 Nodereal 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 Nodereal payment history." If connected, Cascade will call the Nodereal tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "nodereal-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 NodeReal. 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 Nodereal 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 Nodereal MCP in Windsurf

You edit your `~/.codeium/windsurf/mcp_config.json` file to add the server to your `mcpServers` list. Once saved, the MCP integration auto-discovers all 24 tools for immediate use.

Yes, Windsurf can call `debug_trace_transaction` to pull full execution traces. Cascade parses the trace to pinpoint exactly why an EVM transaction failed in your local environment.

No, because Nodereal uses optimized RPC endpoints that return block receipts and token balances in milliseconds. This speed allows Cascade to chain multiple calls without causing UI lag in your editor.

This setup supports both Aptos and EVM-compatible networks. You can run `aptos_get_ledger_info` or standard `eth_block_number` queries side-by-side in the same workspace.

The server only processes blockchain queries, wallet addresses, and transaction hashes. Your Nodereal credentials are kept locally in your Windsurf configuration and never sent to third-party tracking services.

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