How to Use the Chiirp MCP in Windsurf

Q: How does Windsurf use Chiirp to manage contact tags?

Windsurf's Cascade agent uses the applytag and removetag tools from this MCP server. You just tell it which contacts to tag, and it executes the commands on your Chiirp account automatically.

Let Windsurf's Cascade agent run your Chiirp marketing automations for you. Set a goal, it does the rest.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chiirp MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Contact Segmentation

Cascade can now manage your Chiirp contacts directly from your IDE. Tell it to find a group of users and apply a new tag, and it will chain `search_contacts` and `apply_tag` on its own. No hand-holding required. This is perfect for kicking off new campaigns. For instance, you could instruct Cascade to "Find all contacts in California and add the 'west-coast-promo' tag." It just works. You see the result, not the boring steps in between.

Audit Campaigns with Windsurf

Point Cascade at your Chiirp account and ask for a rundown of active campaigns and sequences. It uses `list_campaigns` and `list_sequences` to pull the data right into your editor. You don't have to log into another dashboard. Get a quick summary of what's running, what tags are in use (`list_tags`), and how your automations are structured, all without leaving Windsurf. It's the fastest way to check on your marketing funnels.

Full Lead Management via your MCP Server

Go beyond just reading data. Have Cascade create, update, and manage contacts from start to finish. Give it a phone number and some details, and it'll run `create_contact` or `update_contact` for you. This means you can build complex workflows right in Windsurf. Try a prompt like, "Take this list of new signups, create Chiirp contacts for them, and then apply the 'new-signup-2024' tag." Cascade handles the entire sequence.

Setup guide

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

mcp_config.json

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

Windsurf's Cascade agent uses the `apply_tag` and `remove_tag` tools from this MCP server. You just tell it which contacts to tag, and it executes the commands on your Chiirp account automatically.

Yes. Instruct Cascade to create a contact with a phone number and any other details. It will use the `create_contact` tool on your behalf, without you needing to prompt every step.

Ask Cascade to "list all my Chiirp campaigns." It will run the `list_campaigns` tool and show you the output right in the IDE. No need to switch contexts or open a new tab.

This server follows the MCP standard, so it works with any compatible client. It's especially effective with Windsurf because Cascade can chain multiple Chiirp tools together to complete a single, high-level goal.

This server only accesses your Chiirp contact lists, campaign names, and tag data. All requests are sent over a secure, encrypted channel managed by Vinkius, and your auth token is kept isolated. Windsurf never sees your raw Chiirp credentials.

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