How to Use the Northbeam MCP in Windsurf

Q: How does Windsurf interact with Northbeam attribution data?

Windsurf runs the createdataexport tool to pull raw Northbeam performance metrics directly into your editor. Cascade then automatically polls the status using getexportstatus until the file is ready to parse.

Q: Can I schedule recurring reports using Northbeam and Windsurf?

Yes, Cascade calls listscheduledexports to see your active Northbeam automated reporting runs. Windsurf can then write custom scripts to process those files as soon as they drop.

Q: How do I configure this Northbeam MCP Server in Windsurf?

Open your global config file at /.codeium/windsurf/mcpconfig.json and add the Northbeam server configuration under the mcpServers key. Windsurf immediately registers the MCP server.

Q: Can Cascade monitor active Northbeam webhooks?

The agent uses listwebhooks to inspect active Northbeam endpoints. This allows Cascade to check where your attribution events are routing without opening a web browser.

Run multi-step marketing attribution pipelines in Windsurf without leaving your workspace.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate attribution extraction in Windsurf

`create_data_export` starts a background job to pull your Northbeam marketing metrics based on specific attribution models. Windsurf chains this with `get_export_status` to monitor the export progress without you needing to manually prompt Cascade for each step. Cascade checks the run state and downloads the resulting Northbeam CSV file once ready. You get the raw conversion metrics directly in your Windsurf editor for immediate analysis.

Inspect active marketing schemas

`list_attribution_models` returns the exact Northbeam logic options, like Clicks or Modeled, currently configured in your account. Your Windsurf agent reads these models to align its next queries with your team's specific definition of a conversion. Cascade pairs these Northbeam models with `list_breakdowns` to isolate performance by platform or campaign. This prevents Windsurf from guessing which dimensions are valid when structuring your reporting files.

Map account structures with this MCP Server

`get_account_info` retrieves your active Northbeam workspace metadata to verify your environment settings. Windsurf uses this data to confirm which ad accounts and tracking pixels are currently sending attribution details. Cascade reads these settings alongside `get_dashboard_settings` to see how your team views Northbeam performance. Knowing your dashboard layout helps Cascade format custom reports that match your existing Windsurf project templates.

Setup guide

Set up Northbeam MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Northbeam MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Northbeam payment history." If connected, Cascade will call the Northbeam tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "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 Windsurf

Windsurf runs the `create_data_export` tool to pull raw Northbeam performance metrics directly into your editor. Cascade then automatically polls the status using `get_export_status` until the file is ready to parse.

Yes, Cascade calls `list_scheduled_exports` to see your active Northbeam automated reporting runs. Windsurf can then write custom scripts to process those files as soon as they drop.

Open your global config file at `~/.codeium/windsurf/mcp_config.json` and add the Northbeam server configuration under the `mcpServers` key. Windsurf immediately registers the MCP server.

The agent uses `list_webhooks` to inspect active Northbeam endpoints. This allows Cascade to check where your attribution events are routing without opening a web browser.

Windsurf processes your Northbeam ad spend and conversion reports entirely within local V8 sandboxes. Your raw credentials and export files never touch third-party servers outside your direct Windsurf connection.

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