How to Use the Cometly MCP in Cursor

Q: How do I configure Cometly inside my Cursor editor?

You can add this MCP Server to your .cursor/mcp.json file in your project root or globally. Once saved, enable Agent mode in your chat panel to start calling the tracking tools.

Q: Can Cursor automatically send test purchases to Cometly?

Yes, you can ask the Cursor agent to run trackpurchase with test parameters during your coding session. It will execute the tool and return the API response directly inside your editor.

Q: Does the Cometly MCP integration work in Cursor Agent mode?

Yes, Agent mode can autonomously decide to call listadaccounts or getcampaignstats when you ask questions about your active marketing setups. This lets the AI write code based on real, live configuration data.

Q: How do I view all tracked conversion events?

Simply ask the editor to run listevents. It will output the list of active tracking events directly in your sidebar so you can reference them while coding.

Write attribution code and query Cometly campaigns directly in Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cometly MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write and verify tracking code using this MCP Server

The `track_event` and `track_purchase` tools let your Cursor agent test conversion tracking while you write the backend code. You can make the agent generate a tracking script and immediately run it to verify the integration works. This eliminates the guesswork of setting up pixel events in your codebase. Your editor runs the tool, hits the API, and confirms that the event registered correctly on your dashboard.

Debug attribution campaigns without leaving Cursor

The `list_campaigns` and `get_campaign_stats` tools give your editor direct access to your live marketing performance data. When you are writing custom reporting scripts, your agent pulls real campaign stats to verify your data models. You can stop pasting mock JSON payloads into your test suites. Cursor uses the active MCP Server connection to grab actual marketing numbers, making your local development environment highly accurate.

Query attributed contacts directly from your code editor

The `list_contacts` and `list_events` tools allow your Agent mode to pull real attribution paths directly into your workspace. If you are building a custom CRM sync, your agent can inspect the exact customer journey format. This saves hours of API documentation reading. Your editor queries the live endpoint, showing you exactly how the contact fields are structured so you can write perfect TypeScript interfaces.

Setup guide

Set up Cometly 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 Cometly 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 Cometly transactions." If the MCP tools are loaded correctly, Cursor will call the Cometly tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "cometly-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 Cometly. 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 Cometly 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 Cometly MCP in Cursor

You can add this MCP Server to your `.cursor/mcp.json` file in your project root or globally. Once saved, enable Agent mode in your chat panel to start calling the tracking tools.

Yes, you can ask the Cursor agent to run `track_purchase` with test parameters during your coding session. It will execute the tool and return the API response directly inside your editor.

Yes, Agent mode can autonomously decide to call `list_ad_accounts` or `get_campaign_stats` when you ask questions about your active marketing setups. This lets the AI write code based on real, live configuration data.

Simply ask the editor to run `list_events`. It will output the list of active tracking events directly in your sidebar so you can reference them while coding.

Your ad account credentials and campaign configurations are encrypted and stored inside Vinkius's zero-trust sandbox. Cursor only receives the final JSON payload through a secure, authenticated bridge, preventing any leakage of your marketing 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