How to Use the Adafruit IO MCP in Windsurf

Q: How do I connect the Adafruit IO MCP Server to Windsurf?

Open /.codeium/windsurf/mcpconfig.json or use the Settings UI under Cascade. Add the Vinkius endpoint URL and your token to the mcpServers block. Click refresh in the MCP panel to load the tools.

Q: Can Windsurf read my Adafruit IO dashboards?

Yes, the agent calls listdashboards and getdashboard to inspect your current UI layouts. It reads the block configurations and data bindings directly from the API.

Give Windsurf direct access to your IoT hardware data. Let Cascade pull live sensor feeds and build dashboards autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Adafruit IO MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain IoT Data Workflows in Windsurf

Cascade uses `list_feeds` and `get_feed` to map your entire Adafruit IO device network. You tell the agent to analyze your temperature sensors, and it pulls the exact feed IDs without asking for manual configuration. It knows how to navigate the hardware graph. Once it finds the target feeds, the agent loops through `list_data` to grab historical values. It chains these responses directly into your Python scripts or React components, writing the visualization code while you watch.

Inspect Hardware Triggers

Debugging broken alerts requires pulling the raw rules via `list_triggers` and `get_trigger`. Cascade fetches the threshold conditions attached to your hardware feeds and compares them against your local application logic. You avoid switching tabs to the Adafruit web console. The agent reads the trigger states right in the IDE, spots the misconfigured webhook, and updates your deployment scripts to match the actual server configuration.

Map Device Groups

Organizing massive sensor arrays happens through `list_groups` and `get_group`. Cascade pulls the hierarchical structure of your IoT deployment, mapping out which devices belong to which physical locations. If you need a script to aggregate moisture levels across a greenhouse, the agent queries the specific group first. It writes the data aggregation logic based on the actual hardware topology returned by the MCP Server.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "adafruit-io-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 Adafruit IO. 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 Adafruit IO 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 Adafruit IO MCP in Windsurf

Open ~/.codeium/windsurf/mcp_config.json or use the Settings UI under Cascade. Add the Vinkius endpoint URL and your token to the mcpServers block. Click refresh in the MCP panel to load the tools.

Yes, the agent calls `list_dashboards` and `get_dashboard` to inspect your current UI layouts. It reads the block configurations and data bindings directly from the API.

No, Cascade operates autonomously. Once you ask it to analyze a sensor, it executes the required tool calls sequentially until it gathers all the requested data points.

Cascade paginates through the records using the built-in limits of the API. It processes the chunks in memory before writing the aggregated results to your local files.

Vinkius runs the server in an ephemeral V8 Isolate Sandbox. Your raw sensor values, trigger conditions, and device group names pass through a zero-trust tunnel. We never store your hardware data payloads.

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