How to Use the Covalent MCP in Windsurf

Q: How does Windsurf use Covalent to check wallet balances?

Windsurf calls gettokenbalances through the MCP connection to retrieve current holdings for any wallet address. Cascade can then automatically pass those tokens to other tools to calculate historical values or fetch metadata.

Let Cascade pull wallet histories, token balances, and NFT data directly into your Windsurf workspace 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 Covalent MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit multi-chain wallets inside Windsurf

The `get_token_balances` tool retrieves raw and formatted balances across dozens of chains directly inside your active workspace. Cascade takes this output and automatically feeds it into `get_historical_portfolio` to plot a wallet's financial trajectory over time. You don't need to write manual fetch loops or parse messy payloads. The agent handles the API calls, cleans up the decimals, and maps out the wallet's history in one go.

Track DEX liquidity pools with Cascade

The `get_dex_pools` tool exposes reserve amounts, token pairs, and volume metrics for specific decentralized exchanges. When Cascade spots an active pool, it can run `get_token_transfers` to track the exact flow of funds moving through those pairs. This setup lets you trace liquidity movements without leaving your editor. Cascade sets up the sequence, reads the pool metrics, and presents the raw transfer logs in a clean format.

Deep dive into block details using this MCP Server

Using this MCP Server, your agent calls `get_block_details` and `get_transaction_details` to inspect block hashes, gas metrics, and decoded event logs. You get the raw transaction data and the exact block height sync status via `get_chains_status` without manual block explorer searches. Cascade chains these tools to debug smart contract events. It reads the raw log parameters, matches them against the block timestamp, and finds the exact point of failure.

Setup guide

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

mcp_config.json

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

Windsurf calls `get_token_balances` through the MCP connection to retrieve current holdings for any wallet address. Cascade can then automatically pass those tokens to other tools to calculate historical values or fetch metadata.

Yes, Cascade excels at this. You can ask it to find a wallet's NFTs using `get_nft_balances` and then immediately inspect the transaction history of those assets using `get_transactions` in a single run.

You can query over 100 supported networks. Ask Cascade to run `list_supported_chains` to get an active list of chain IDs and features right inside your editor.

No. Vinkius handles the underlying authentication. You paste your single endpoint token into your `mcp_config.json` file, and Windsurf gains instant access to every supported network.

No, it only handles public blockchain addresses and transaction hashes. The server queries public ledger data, and your private keys never touch the Vinkius sandbox or the API endpoint.

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