How to Use the Aimtell MCP in Windsurf

Q: Can Windsurf run a whole Aimtell campaign on its own?

Yes, it can. Cascade chains tools like listapicampaigns and sendoneoffnotification to draft, test, and trigger alerts based on your instructions.

Q: How does Windsurf handle subscriber segment updates in Aimtell?

The agent calls listsegments to find the right group, then updates metadata using addsubscriberattribute. It does this directly through the API, skipping manual exports.

Run entire web push campaigns autonomously by connecting Aimtell to Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aimtell MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Campaign Performance Audits

This MCP Server exposes tools like `get_campaign_performance` and `list_campaigns` so Cascade can analyze your push notifications. Cascade reads your goals, grabs the raw metrics, and flags underperforming notifications without you asking. You'll get a clear picture of which push alerts drive clicks. The agent handles the tedious work of digging through stats, letting you focus on writing copy.

Dynamic Segmenting with the Windsurf MCP Server

Cascade uses `list_segments` and `add_subscriber_attribute` to group your users based on real-time behavior. Instead of manually exporting CSVs, you tell the agent who to target and it updates subscriber profiles instantly. This turns static lists into active targeting groups. Your development environment becomes the control center for your entire push audience.

Instant Push Notification Testing

You can trigger live alerts using `send_one_off_notification` to test your messaging instantly. Cascade chains this tool with `list_sites` to verify that your push payload looks right on every domain. It cuts out the browser dashboard entirely. You see exactly how your notifications behave before scheduling a massive send.

Setup guide

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

mcp_config.json

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

Add the server configuration to your local config file under the mcpServers key. Windsurf discovers the MCP tools when you restart.

Yes, it can. Cascade chains tools like `list_api_campaigns` and `send_one_off_notification` to draft, test, and trigger alerts based on your instructions.

The agent calls `list_segments` to find the right group, then updates metadata using `add_subscriber_attribute`. It does this directly through the API, skipping manual exports.

Speed is the main advantage. You write, test, and analyze push campaigns from the same place you write your code, removing the need to context-switch when using this MCP setup.

Vinkius runs the server in an isolated sandbox, meaning your subscriber attributes and campaign metrics are never stored on the platform. Your API credentials stay encrypted, and data only flows between your IDE and the push service.

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