How to Use the Alchemy MCP in Windsurf

Q: How do I add the Alchemy server to my Windsurf setup?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings menu, navigate to Cascade, and add it via the MCP Servers UI.

Q: What happens if the Alchemy API goes down while using Windsurf?

Running checkapistatus allows Cascade to verify if the service is operational. If the node provider is down, the interface displays the outage details immediately.

Track live Ethereum balances and NFT ownership directly inside your Windsurf Cascade sessions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alchemy MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit live wallet assets using Windsurf Cascade

The Alchemy MCP Server lets Cascade scan Ethereum addresses to pull real-time balances and asset lists instantly. When you ask Cascade to review a wallet, it automatically runs `get_wallet_balance` and `get_token_balances` to map out the user's entire portfolio without making you copy-paste raw hex data from Etherscan. Cascade uses this live context to write precise smart contract tests or build UI components that match the actual token distribution. You get accurate on-chain data from Alchemy fed directly into your active Windsurf workspace.

Verify transaction status during active debugging

This server exposes `get_transaction_receipt` to let your Windsurf agent inspect the outcome of any smart contract execution on-chain. By analyzing the returned data, Cascade checks the gas used and verifies if the transaction succeeded or reverted. If a local integration test fails, Cascade pulls the actual mainnet receipt to compare event logs. Your development loop stays entirely within the editor, eliminating manual browser checks.

Inspect NFT portfolios to build dynamic web3 views

Querying with the `get_owned_nfts` tool lets Cascade retrieve every digital collectible held by a specific wallet via MCP. Its processing engine parses the returned metadata to scaffold frontend galleries or write custom filtering logic on the fly. Instead of hardcoding mock data, you let Cascade pull real NFT contracts to populate your React or Vue components. Real-time node queries ensure your Windsurf development environment behaves exactly like the production Ethereum mainnet.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "alchemy-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 Alchemy. 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 Alchemy 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 Alchemy MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings menu, navigate to Cascade, and add it via the MCP Servers UI.

Yes, Cascade chains these queries autonomously. For example, it can check a wallet balance with `get_wallet_balance` and then immediately fetch its NFTs using `get_owned_nfts` without waiting for your next prompt.

Running `check_api_status` allows Cascade to verify if the service is operational. If the node provider is down, the interface displays the outage details immediately.

No, this MCP Server routes all blockchain queries directly through Alchemy's infrastructure. You only need a Vinkius endpoint token to get real-time mainnet data.

Vinkius runs the server in an isolated V8 sandbox that never persists your queried Ethereum addresses or transaction hashes. Your data only flows to the Alchemy API to fetch the requested on-chain records and is immediately discarded.

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