How to Use the Grid MCP in Windsurf

Q: Can I see my Grid dashboards in Windsurf?

You can list and access them using listgriddashboards. Windsurf will then help you pull the specific worksheet details required to render that data.

Q: What happens if the Grid API is down in Windsurf?

The server will return an error during the checkapihealth call. Windsurf will report this immediately so you don't waste time trying to query unreachable data.

Use Grid with Windsurf to turn raw spreadsheet data into live dashboards that update as your team works.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Grid MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Grid tools directly in Windsurf

Cascade doesn't wait for your approval to fetch data. It uses `list_grid_worksheets` and `list_worksheet_records` to pull the latest numbers automatically. You can ask it to build a dashboard, and it will call `list_grid_dashboards` to find the right view, then map the data to your UI without you typing a single line of code.

Manage operational data inside Windsurf

Stop switching tabs to update your tracking sheets. When you need to change a value, Cascade runs `update_worksheet_record` to push the edit to your live Grid data. It handles the logic behind the scenes. You just state the goal, and it executes the sequence needed to keep your records current.

Check your Grid connection status

Windsurf keeps you informed about your connection health before you start a task. It calls `check_api_health` to verify that your data is reachable. If the server isn't responding, you'll know immediately. It prevents failed tool executions by confirming the connection path is clear.

Setup guide

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

mcp_config.json

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

Open your Windsurf settings and go to the Cascade MCP panel. You can add the server configuration directly there or use the built-in marketplace to install it with one click.

Yes, it supports full read and write operations. You can use tools like `create_new_operational_record` or `remove_worksheet_record` to manage your data without leaving the editor.

You can list and access them using `list_grid_dashboards`. Windsurf will then help you pull the specific worksheet details required to render that data.

Your data remains within the established secure tunnel. The Grid MCP server only interacts with your specific account credentials, ensuring that your operational records stay isolated.

The server will return an error during the `check_api_health` call. Windsurf will report this immediately so you don't waste time trying to query unreachable data.

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