Northbeam Connector for AI agents.

Q: Can I download data directly through the agent?

Yes! The getexportstatus tool will provide a direct download URL once the export status is marked as 'SUCCESS'.

10 live capabilities

Track marketing attribution and ad spend performance with your agent.

Live agent request Northbeam / Connector

Waiting for input…

AI Agent

Why people use Northbeam

Northbeam for Accurate Marketing Attribution Reporting

This Connector lets you skip the clicking. You can ask your agent to pull the latest performance metrics or check your export history. You get the answers you need directly in your chat window, turning a multi-step manual process into a single conversation.

What Vinkius changes

You get a conversational interface for your marketing attribution data without the manual dashboard navigation.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Quick ROAS checks during meetings

A marketing manager needs to know the ROAS for a specific campaign.
Real-world use case 02

Automated monthly audit pulls

A data analyst needs to run a monthly audit.
Real-world use case 03

Verifying automation health

A growth lead wants to see if their webhooks are active.

Complete set · 10capabilities

The complete Northbeam capability set.

These are the exact actions your AI can choose when you ask it to work with Northbeam.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through Northbeam.

01 Capability
Get dashboard settings
View your workspace dashboard configurations. This helps keep your agent updated on your specific setup.
02 Capability
List breakdowns
See which labels like Platform or Campaign are available for your reports. Use this to understand your data granularity.
03 Capability
List scheduled exports
See a list of all your recurring, scheduled data exports. This helps you keep track of your automated data feeds.
04 Capability
Create data export
Start a new data export for specific metrics and dates. This lets you pull custom data without manual work.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through Northbeam.

05 Capability
Get export status
Check if a specific export is finished and get the download link. Use this to monitor long-running data pulls.
06 Capability
Get account info
Pull the high-level metadata for your authenticated account. This provides context for your agent about your workspace.
07 Capability
List metrics
See which performance metrics like Spend or Revenue are available for export. This helps you know what data you can request.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through Northbeam.

08 Capability
List attribution models
View the different attribution models supported by your account. This clarifies how your marketing credit is assigned.
09 Capability
List recent exports
See a history of your most recently completed data exports. Use this to verify that your previous data pulls were successful.
10 Capability
List webhooks
See all the active webhooks currently running in your workspace. This helps you monitor your automated data pipelines.

Set up in minutes

One URL. Then ask Northbeam to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Northbeam from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Northbeam, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Northbeam for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Northbeam URL.
Step 03

Save and start

Save the connection and enable Northbeam in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "northbeam": {
      "url": "https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Northbeam

Open Agent mode in chat and ask: "Using Northbeam, help me...". 10 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "northbeam": {
      "url": "https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Northbeam

Ask Copilot: "Using Northbeam, help me...". 10 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "northbeam": {
      "url": "https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Northbeam

Open Cascade and ask: "Using Northbeam, help me...". 10 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "northbeam": {
      "url": "https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Northbeam

Ask Cline: "Using Northbeam, help me...". 10 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add northbeam --transport http "https://edge.vinkius.com/vk_preview_9oP8RXhoOI2Cirhogu1lpv1mnfHydfPY91UxvjJq/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Northbeam

Ask Claude: "Using Northbeam, show me...". 10 tools are ready

Where the request belongs

Work Northbeam can move forward.

Built around the request

This is for marketing leads and data analysts who are tired of manual data pulling and want to move faster on attribution reporting.

Marketing Manager

Checks campaign performance and export statuses during weekly meetings.

Data Analyst

Automates the retrieval of complex attribution sets for monthly reporting.

Growth Lead

Monitors real-time spend and revenue metrics to adjust ad budgets on the fly.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

LeadsRx

Analyze marketing attribution and track conversions via LeadsRx. get campaign results and touchpoint insights directly from your AI agent.

View Connector

02 10 capabilities

Amazon Marketing Cloud

Advanced advertising analytics. execute SQL queries and monitor workflows via AI.

View Connector

03 8 capabilities

Cometly

Enable your AI agent to track conversions, retrieve attribution data, and monitor campaigns via the Cometly API.

View Connector

04 5 capabilities

Adobe Analytics

Customer journey insights. retrieve reports, manage segments, and audit metrics via AI.

View Connector

05 8 capabilities

Measured

Marketing performance and incrementality analytics via Measured. track ROAS and cross-channel impact.

View Connector

06 4 capabilities

Attribution Model Comparator

Compare 5 attribution models (First Touch, Last Touch, Linear, etc.) to quantify revenue delta across all marketing channels.

View Connector

Bring your own AI

Change the model, client or framework. Keep Northbeam connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Northbeam.

The practical details behind the request, access and result.

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 capability 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 capabilities to see all valid parameters available for your account before creating a new data export.

One connection away

Give your agent a direct line to Northbeam.

Connect Northbeam once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Northbeam for Accurate Marketing Attribution Reporting

You get a conversational interface for your marketing attribution data without the manual dashboard navigation.

Quick ROAS checks during meetings

Automated monthly audit pulls

Verifying automation health

Get dashboard settings

List breakdowns

List scheduled exports

Create data export

Get export status

Get account info

List metrics

List attribution models

List recent exports

List webhooks

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Northbeam

Create MCP config

Add the server config

Enable Agent mode

Start using Northbeam

Open MCP Settings

Add the server

Save and reload

Start using Northbeam

Open Cline MCP Settings

Add remote server

Enable the server

Start using Northbeam

Install Claude Code

Add the Connector

Verify the connection

Start using Northbeam

Marketing Manager

Data Analyst

Growth Lead

LeadsRx

Amazon Marketing Cloud

Cometly

Adobe Analytics

Measured

Attribution Model Comparator

Give your agent a direct line to Northbeam.