How to Use the Northbeam MCP in Cline

Q: How does Cline fetch my Northbeam marketing metrics?

Cline calls listmetrics to see what performance fields are available for your Northbeam account. It then runs createdataexport to generate the matching CSV directly in your VS Code workspace.

Q: Can Cline help me debug webhook integrations with Northbeam?

Yes, Cline uses listwebhooks to inspect your active Northbeam data destinations. The agent then writes local Node.js or Python code to mock and test those incoming payloads.

Q: Can Cline view my current Northbeam dashboard configurations?

The Cline agent runs getdashboardsettings to retrieve your current Northbeam workspace layout. This lets you align your local scripts with the exact attribution windows configured on your live dashboard.

Build data pipelines and generate ad spend reports directly inside VS Code using Cline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Northbeam MCP to Cline

Create your Vinkius account to connect Northbeam to Cline 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 Northbeam with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build automated reporting scripts in Cline

`create_data_export` initiates a new Northbeam attribution report export based on your live marketing spend. Cline takes the resulting export ID and writes a custom script to poll `get_export_status` until the download is complete. Because Cline writes and executes code locally, it can immediately process the downloaded Northbeam metrics. You get clean, formatted CSVs generated in your Cline workspace directory without manual intervention.

Audit webhooks and active data streams

`list_webhooks` pulls all active endpoints currently receiving Northbeam conversion notifications from your account. Cline inspects this list to debug broken data pipelines or verify that your server-side tracking is firing. If a Northbeam endpoint is missing, Cline writes the necessary integration code to handle incoming payloads. It uses the live schema to ensure your local Cline project files match the expected structure.

Query dimensions using the MCP Server

`list_breakdowns` exposes the valid Northbeam dimensions like campaign, platform, or ad set that you can use in queries. Cline reads this list to prevent errors before triggering large data exports. The Cline agent combines these dimensions with `list_metrics` to build precise query schemas. This ensures your local Cline reporting scripts only request fields that actually exist in your Northbeam account.

Setup guide

Set up Northbeam MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type northbeam-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Northbeam refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "northbeam-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 Northbeam. 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 Northbeam 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 Northbeam MCP in Cline

Cline calls `list_metrics` to see what performance fields are available for your Northbeam account. It then runs `create_data_export` to generate the matching CSV directly in your VS Code workspace.

Yes, Cline uses `list_webhooks` to inspect your active Northbeam data destinations. The agent then writes local Node.js or Python code to mock and test those incoming payloads.

Click the MCP icon in the Cline sidebar and add the Northbeam server under the Remote Servers tab. Alternatively, insert the server details directly into your `cline_mcp_settings.json` file.

The Cline agent runs `get_dashboard_settings` to retrieve your current Northbeam workspace layout. This lets you align your local scripts with the exact attribution windows configured on your live dashboard.

Cline runs inside your local VS Code environment, meaning your Northbeam marketing metrics remain isolated. All API communication occurs over encrypted channels directly to the Northbeam attribution engine.

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