# Cometly MCP for AI Agents AI Agent Connect > Cometly lets your AI agent handle ad attribution across Meta, Google, and TikTok. It tracks conversions, pulls ROAS and CPA stats, and maps out which ads actually drive your best customers. You get a clear view of your marketing spend without switching tabs between different ad managers. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_tjnAcuMoJeFSwhAva5qM5OWI0AXcggv03WnqKGLv/ai-agent-connect - **Tags:** ad-attribution, roas, conversion-tracking, marketing-analytics, campaign-management, cpa-tracking ## Description Stop jumping between five different tabs just to see if your ads are actually making money. This Connector connects your AI agent directly to Cometly, giving it the eyes it needs to see the full picture of your marketing performance. Instead of manually exporting CSVs or squinting at messy dashboards, you can just ask your agent to tell you which campaigns are hitting their targets or which specific ads are driving the highest-value leads. It handles the heavy lifting of pulling attribution data from platforms like Meta and Google so you can focus on making decisions. Since it's hosted on Vinkius, you can plug it into your existing workflow and start querying your marketing data through natural conversation. It makes tracking purchases and leads feel like a quick chat rather than a data entry project. ## Tools ### get_campaign_stats Pulls performance metrics like spend and revenue for a specific campaign. This helps you see live ROAS and CPA. ### list_ad_accounts Shows all connected ad accounts from platforms like Meta and Google. Use this to see your full account overview. ### list_campaigns Provides a full list of all ad campaigns currently being tracked. It helps you see everything in one place. ### track_event Sends a custom conversion event to Cometly for better attribution. This is useful for non-standard actions. ### track_lead Records a new lead event quickly for real-time tracking. It helps you capture high-intent interest immediately. ### track_purchase Sends a purchase event to Cometly to map the customer journey. This links a sale directly to an ad source. ### list_contacts Retrieves a list of attributed contacts along with their journey data. This maps out the customer path. ### list_events Shows a list of all tracked events within your Cometly account. Use this to see what actions are being captured. ## Prompt Examples **Prompt:** ``` How is my 'Summer Sale' campaign doing on Meta compared to Google? ``` **Response:** ``` Here is the performance for your 'Summer Sale' campaigns: | Platform | Spend | Conversions | ROAS | CPA | | :--- | :--- | :--- | :--- | :--- | | **Meta** | $1,200 | 45 | 4.2x | $26.67 | | **Google** | $900 | 38 | 5.1x | $23.68 | Google is currently showing a better ROAS for this campaign. ``` **Prompt:** ``` Track a new lead from 'marketing@example.com' for a $500 service. ``` **Response:** ``` Lead tracked successfully for marketing@example.com. I've sent the event to Cometly to start building their attribution profile. ``` **Prompt:** ``` Who are our top 3 best performing campaigns by ROAS? ``` **Response:** ``` Your top 3 campaigns by ROAS are: 1. **Retargeting_Q3** (Google) - 6.2x ROAS 2. **Lookalike_1%** (Meta) - 4.8x ROAS 3. **Brand_Search** (Google) - 4.5x ROAS ``` ## Capabilities ### Track purchases and leads Send conversion data to Cometly so your agent can map the customer journey. ### Pull ROAS and CPA stats Get live performance numbers for specific campaigns without opening a browser. ### See high-value conversions Identify which specific ads are driving your most profitable customers. ### List connected ad accounts View all your linked accounts from Meta, Google, and TikTok in one place. ### View customer journey data See the path attributed contacts took before converting. ## Use Cases ### Analyzing underperforming Meta ads A marketer needs to know why a specific Meta ad is underperforming. They ask the agent to pull stats for the campaign using get_campaign_stats and compare it to others. ### Tracking real-time e-commerce sales An e-commerce owner just had a big sale. They tell the agent to track_purchase for a specific order to see which ad drove the sale. ### Identifying profitable lead channels A growth lead needs to see which channels are actually working. They ask the agent to list all campaigns and sort them by ROAS. ### Mapping customer journeys A team wants to see who their best leads are. They use list_contacts to see the journey data for high-value customers. ## Benefits - Stop manual data exports by using get_campaign_stats to pull live performance numbers directly into your chat. - See the full customer path by using list_contacts to view journey data for every attributed lead. - Save time on manual entry by using track_purchase to send conversion data to Cometly instantly. - Get a bird's-eye view of your spend with list_ad_accounts to see every connected platform at once. - Identify your winners faster by using list_campaigns to compare all active marketing efforts in one list. ## How It Works The bottom line is you get a direct line to your marketing attribution data without leaving your chat interface. 1. Add the Cometly MCP to your AI client. 2. Input your API Key from the Cometly account settings. 3. Ask your agent to pull stats or track new conversions. ## Frequently Asked Questions **What does the Cometly MCP actually do for my marketing?** It connects your AI agent to your ad attribution data. You can ask it to pull stats, track conversions, and see which ads are actually driving your revenue across different platforms. **Can I use Cometly MCP to see my ROAS?** Yes. You can ask your agent to pull live ROAS and CPA stats for any specific campaign you're tracking in Cometly. **How do I track a purchase with Cometly?** You can just tell your agent to track a purchase. It will send that data to Cometly so you can see which ads were responsible for that specific sale. **Does the Cometly MCP work with Meta and Google ads?** Yes, it pulls attribution data from several major platforms including Meta, Google, and TikTok to give you a unified view of your marketing. **Is Cometly MCP good for e-commerce?** It's perfect for e-commerce. It helps you track purchase attribution across all your channels so you know exactly where your customers are coming from. **Can I see customer journeys using Cometly?** Yes, you can ask your agent to list your attributed contacts. It will show you the journey data for those customers, helping you see how they interacted with your ads. **How do I get my Cometly API key?** Log in to Cometly, go to **Account Settings > API Keys**, copy your key, and paste it below. **Is this the same as Meta Conversions API (CAPI)?** No. Cometly acts as a bridge: it receives events, attributes them, and syncs data back to Meta, Google, TikTok, etc. **What event types are supported?** Standard events: Purchase, Lead, Add To Cart, Initiate Checkout. You can also use custom event names.