How to Use the Aimtell MCP in Cursor

Q: How do I trigger an Aimtell campaign from Cursor?

Ask the chat agent to fire a test message. It executes sendoneoffnotification using the parameters you define in the prompt.

Inject live Aimtell subscriber data into your codebase using Cursor.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build notification logic fast

Writing API wrappers for push alerts burns hours. Let your MCP server pull live data to generate working code instead of guessing the response structure. The editor calls `list_api_campaigns` to see your existing setup. Then it writes the exact implementation you need to trigger those campaigns programmatically.

Test segments in Cursor

Hardcoding user IDs for testing is a terrible habit. Your editor can grab real audience slices while you write your targeting logic. Tell the agent to execute `list_segments` and `list_sites`. It pulls the actual segment IDs from your account so your code works on the first run.

Debug the Aimtell MCP Server

Stop switching between your IDE and the web dashboard to figure out why a push failed. You can check the logs right where you write the code. Have the agent run `get_campaign_performance` to verify delivery. If things look wrong, `list_triggered_campaigns` shows exactly what automated rules fired.

Setup guide

Set up Aimtell MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Aimtell MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Aimtell transactions." If the MCP tools are loaded correctly, Cursor will call the Aimtell tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Create an mcp.json file in your project root. Add the Vinkius endpoint URL under the mcpServers section. Turn on Agent mode in the chat panel to start.

The editor reads your active audience directly. It uses the list_subscribers tool to inject real user IDs into your testing environment.

Ask the chat agent to fire a test message. It executes send_one_off_notification using the parameters you define in the prompt.

That is the whole point. The agent inspects your active setup and writes the exact fetch requests needed to automate your push strategy.

We run a zero-trust architecture for every connection. Your click rates and segment definitions pass through a temporary sandbox that destroys itself after the task finishes.

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