# Northbeam MCP for AI Agents AI Agent Connect > Northbeam MCP lets you pull and analyze marketing attribution data directly through your AI client. Get real-time insights into spend, revenue, and campaign performance without jumping between tabs or manual CSV exports. It turns your marketing data into a conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/ai-agent-connect - **Tags:** marketing-attribution, revenue-tracking, ad-spend, performance-metrics, first-party-data ## Description Managing marketing attribution usually means digging through messy dashboards or waiting around for huge CSV files to finish downloading. This Connector changes that by letting you talk to your data. Instead of hunting for a specific platform's spend or trying to figure out which campaign actually drove a sale, you just ask your agent to show you the numbers. You can pull specific metrics like attributed revenue or transactions, see how they break down by ad set, and even check the status of your data exports in real-time. It handles the heavy lifting of navigating the Northbeam interface so you can focus on making decisions. Since Vinkius makes it easy to connect these kinds of tools, you can get these insights running in minutes. It's about getting answers quickly when you're in the middle of a strategy meeting or a deep-dive analysis, rather than spending half your day on data entry. ## Tools ### get_dashboard_settings View your workspace dashboard configurations. This helps keep your agent updated on your specific setup. ### list_breakdowns See which labels like Platform or Campaign are available for your reports. Use this to understand your data granularity. ### list_scheduled_exports See a list of all your recurring, scheduled data exports. This helps you keep track of your automated data feeds. ### create_data_export Start a new data export for specific metrics and dates. This lets you pull custom data without manual work. ### get_export_status Check if a specific export is finished and get the download link. Use this to monitor long-running data pulls. ### get_account_info Pull the high-level metadata for your authenticated account. This provides context for your agent about your workspace. ### list_metrics See which performance metrics like Spend or Revenue are available for export. This helps you know what data you can request. ### list_attribution_models View the different attribution models supported by your account. This clarifies how your marketing credit is assigned. ### list_recent_exports See a history of your most recently completed data exports. Use this to verify that your previous data pulls were successful. ### list_webhooks See all the active webhooks currently running in your workspace. This helps you monitor your automated data pipelines. ## Prompt Examples **Prompt:** ``` What metrics can I export from my Northbeam account right now? ``` **Response:** ``` I've checked your account. You can export several key metrics, including: * **Attributed Revenue** * **Transactions** * **Spend** * **ROAS** * **Cost Per Acquisition** Would you like to see the available breakdowns for these as well? ``` **Prompt:** ``` Is my latest data export done? The ID is exp_9988. ``` **Response:** ``` Checking that for you now... The export **exp_9988** is complete. You can download your results here: https://api.northbeam.io/v1/result/exp_9988/download.csv ``` **Prompt:** ``` Show me my recent export history. ``` **Response:** ``` Here are your 3 most recent exports: | Export Name | Status | | :--- | :--- | | Daily Spend Audit | **SUCCESS** | | Weekly Revenue Pull | **SUCCESS** | | Monthly Attribution Test | **FAILED** | I can pull the failure reason for that last one if you'd like. ``` ## Capabilities ### Pull performance metrics Get data on spend, revenue, and transactions instantly. ### Break down marketing data See how numbers split across platforms, campaigns, and ad sets. ### Check attribution models See how credit is assigned across different customer touchpoints. ### Start new data exports Kick off custom data pulls for specific date ranges and metrics. ### Monitor export progress Check the status of active exports and grab the download links. ### View workspace settings See your dashboard configurations and account metadata. ### Track active webhooks Keep an eye on your scheduled exports and automated data feeds. ## Use Cases ### Quick ROAS checks during meetings A marketing manager needs to know the ROAS for a specific campaign. They ask the agent to list metrics and breakdowns, then get the specific numbers instantly. ### Automated monthly audit pulls A data analyst needs to run a monthly audit. They use create_data_export to pull a year's worth of data and check the status until it's ready for review. ### Verifying automation health A growth lead wants to see if their webhooks are active. They ask the agent to list webhooks to verify the automation is still connected and healthy. ### Confirming attribution logic A user wants to know which attribution models are active. They use list_attribution_models to confirm the data is being modeled correctly for their reports. ## Benefits - Stop manual CSV hunting: Use create_data_export to start pulls and get_export_status to get the links without leaving your chat. - Faster performance checks: Use list_metrics and list_breakdowns to quickly see what data is available for your specific marketing channels. - Better attribution clarity: Use list_attribution_models to understand exactly how your marketing spend is being credited for sales. - Real-time workspace oversight: Monitor your list_webhooks and list_scheduled_exports to ensure your data pipelines are running smoothly. - Instant account context: Use get_account_info and get_dashboard_settings to keep your agent updated on your specific workspace configuration. ## How It Works The bottom line is you get a conversational interface for your marketing attribution data without the manual dashboard navigation. 1. Connect your Northbeam API Key and Data Client ID to the Connector. 2. Ask your agent for specific metrics or to start a new data export. 3. Receive structured data, status updates, or direct download links in your chat. ## Frequently Asked Questions **Can the Northbeam MCP help me see my marketing spend?** Yes, it lets your agent pull spend metrics and break them down by platform or campaign so you can see exactly where your money is going. **How do I get my data exports faster with Northbeam MCP?** You can use the Connector to initiate new exports for specific dates and metrics. Your agent will then track the status and give you a direct download link once it's ready. **Can I see which attribution models are being used?** Yes, the Connector can list all supported attribution models in your account, helping you understand how your marketing credit is being calculated. **Does Northbeam MCP work with my current marketing dashboard?** It connects to your Northbeam account data. You can still use your dashboard, but this Connector lets you query that same data through a conversational interface. **Can I check my active webhooks using Northbeam MCP?** Yes, you can ask your agent to list all active webhooks to ensure your automated data feeds are still connected and running correctly. **What kind of breakdowns can I see with Northbeam MCP?** You can see how your data is grouped by labels like Platform, Campaign, and Ad Set, allowing for more granular performance analysis. **Where do I find my Northbeam API credentials?** Log in to your Northbeam Dashboard, navigate to Settings > API Keys. You will find both your API Key and your Data-Client-ID (UUID) there. **Can I download data directly through the agent?** Yes! The `get_export_status` tool will provide a direct download URL once the export status is marked as 'SUCCESS'. **How do I know which metrics I can export?** Use the `list_metrics` and `list_breakdowns` tools to see all valid parameters available for your account before creating a new data export.