Free Northbeam MCP: No-Code Setup

Q: Is there an official Northbeam MCP?

Yes. Northbeam hosts its MCP server at https://mcp.northbeam.io, read-only and included in every Northbeam plan, with each user signing in with their own login. Porter's Northbeam MCP runs at https://mcp.portermetrics.com/mcp and puts Northbeam attribution next to Shopify and your ad accounts. You can connect both in Claude.

Q: What is the Northbeam MCP server URL?

Porter's Northbeam MCP server URL is https://mcp.portermetrics.com/mcp, and Northbeam's own server is https://mcp.northbeam.io. Paste one into Claude, ChatGPT or another AI client as a custom connector. Porter's route takes a Northbeam API key and Data-Client-ID in Porter, while Northbeam's asks each user to sign in.

Free forever plan: unlimited connected accounts, up to 30 days of history (15 days in AI chats) and 100 automation credits a month.
A key you control: a Northbeam API key and Data-Client-ID you create, revocable anytime.
Every model in one answer: attribution models, windows and accounting modes side by side, next to Shopify and your ad accounts.
Safe for live accounts: spend records, models and settings stay exactly as you set them in Northbeam.

Try free

By Kashmala Malik · Last updated November 9, 2026

What is a Northbeam MCP server?

A Northbeam MCP server lets an AI assistant like Claude or ChatGPT reach your Northbeam data through the Model Context Protocol (MCP). You ask in plain language, and the assistant calls the Northbeam API for attribution models, windows and accounting modes by channel and campaign.

Quick setup: paste https://mcp.portermetrics.com/mcp into Claude, ChatGPT or Cursor and sign in with your Porter account. Full steps
Works in: Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex
Data: 647 Northbeam fields across attribution models, windows and accounting modes
Changes: none, Porter only reads Northbeam
Price: free plan, paid plans from $15 per account a month
Official Northbeam server: yes, Northbeam’s own read-only MCP server

Use cases

Northbeam MCP use cases

Porter Metrics connects Northbeam to Claude, ChatGPT and other AI clients through one MCP server built for attribution reporting. Ask which channels each model credits, what a first-time buyer costs or which campaigns pay back on LTV, and Claude answers from a fresh Northbeam export.

Reports

Attribution and revenue

Attributed revenue: Attributed Rev, ROAS, Transactions and MER by platform, campaign, ad set and ad, by day.
Models side by side: Attribution Model, Attribution Window and Accounting Mode come as columns, so Claude compares Clicks-Only, Clicks + Modeled Views and other models in one table.
Meta’s own number beside Northbeam’s: FB ROAS (7D Click, 1D View) and other platform-reported metrics as Northbeam imports them.
Shop channels: Web Shop Revenue, Meta Shop Revenue and TikTok Shop Revenue apart.

Every metric and dimension Porter reads is in the Northbeam fields list.

Customers, CAC and LTV

New vs returning: Rev (1st time), Rev (Returning), CAC (1st time), Transactions (1st time) and Customers (New).
Lifetime value: LTV ROAS, LTV CAC and LTV Attributed Rev, so a slow first week doesn’t hide a campaign that pays back.
Forecasts: Forecasted Attributed Rev (30d), (60d) and (90d), Northbeam’s own revenue forecasts.
Repeat buying: Customer Repurchase Rate (90d) and Orders Per New Customer (90d).

Northbeam next to your marketing

Attribution next to the store: weekly Attributed Rev beside Shopify Total Sales, through the Shopify MCP.
Ad platforms in the same chat: Northbeam’s Meta numbers next to Ads Manager’s, with the Meta Ads MCP and the Google Ads connector for Claude.
Every client in one question: agencies connect each Northbeam client with its own key, and Claude tells them apart with the Client field.

Reports and alerts

Live dashboards: one link that stays current, with nothing to export. Browse the free dashboard templates to start.
Scheduled delivery: a dashboard emailed to you or your team on the day and hour you pick.
Weekly summary: which platforms gained or lost credit, what new buyers cost and what to check next, written in the chat.

Research

Model comparison: the same week under different attribution models and windows, side by side.
Repeat buyers: Customer Repurchase Rate (90d) by the platform that brought the first order.

Audits

Platform over-reporting: Meta and Google’s own ROAS next to Northbeam’s, with the biggest gaps first.
CAC drift: CAC (1st time) by platform, week over week.

Example answer

Demo data, from a fictional brand. Prompt: “Show last week by Platform (Northbeam) with Spend, Attributed Rev, Rev (1st time) and Customers (New), on Clicks + Modeled Views, 7-day window, accrual, with ROAS and CAC (1st time).”

Platform	Spend	Attributed Rev	ROAS	Rev (1st time)	Customers (New)	CAC (1st time)
Meta Ads	$48,200	$104,600	2.17	$61,200	612	$78.76
Google Ads	$31,400	$82,300	2.62	$38,100	401	$78.30
TikTok Ads	$12,800	$19,800	1.55	$14,100	188	$68.09
Email	$1,200	$21,400	17.83	$6,800	74	$16.22

TikTok has the lowest ROAS on Attributed Rev but the cheapest new customers of the ad platforms, so Claude checks their LTV before you cut it.

Reference

Northbeam MCP server reference

One server, every Northbeam client: Porter connects Northbeam to the AI clients, fields and workflows media buyers already use. The same Porter server URL works in Claude, ChatGPT and any MCP client that supports remote servers. Porter runs Northbeam’s data export each time Claude asks, so every answer reflects Northbeam at that moment.

AI clients

Only one AI app?

ClaudeNorthbeam connector

ChatGPTNorthbeam connector

Northbeam metrics

Spend and revenue: Spend · Rev · Attributed Rev · ROAS · MER · Transactions · Visits

New and returning: Rev (1st time) · Rev (Returning) · ROAS (1st time) · CAC · CAC (1st time) · Customers (New) · Transactions (1st time)

Lifetime value: LTV ROAS · LTV CAC · LTV Attributed Rev · Customer Repurchase Rate (90d)

Forecasts: Forecasted Attributed Rev (30d) · Forecasted Attributed Rev (90d) · Forecasted ROAS (90d)

Platform-reported: FB ROAS (7D Click, 1D View) · FB CAC (7D Click, 1D View) · Google ROAS · TikTok ROAS

Porter has 647 ready-made Northbeam fields, 632 metrics and 15 dimensions. Each one is in the full Northbeam field reference.

Dimensions and segments

Time: Date

Attribution: Attribution Model · Attribution Window · Accounting Mode · Touchpoint Kind

Media: Platform · Platform (Northbeam) · Campaign · Ad Set · Ad · Status

Account: Client

Related MCPs

Pair Northbeam with the Shopify MCP, the Google Analytics MCP or the Meta Ads MCP. One Porter connection covers all of them, or see every MCP server.

Other destinations

The same Northbeam connection also sends data to Data Studio (formerly Looker Studio), BigQuery and Google Sheets, at no extra cost.

Northbeam returns one row for each model, window and accounting mode. Name one of each in your question, or group by all three, so Claude never adds the same revenue twice.

Security and trust

Safety and security

Porter’s Northbeam MCP connects with the API key and Data-Client-ID you create, and reports on your account without changing it. Claude reads attribution, spend and customer metrics while your models, spend records and settings stay exactly as you set them in Northbeam. You can delete the key whenever you like.

Safe for live accounts

Every Northbeam question is a report. Budgets live in your ad platforms and settings live in Northbeam, where you change them as usual.

An API key you create

In Northbeam, open Settings → API Keys and create a key to see it with your Data-Client-ID. Every request needs both, sent as headers, per Northbeam’s Data Export API docs.

Claude goes through Porter

Porter runs Northbeam’s export only when Claude asks a question, and Claude never connects to Northbeam directly.

Nothing stored between questions

Porter runs a fresh export on every question and keeps no copy of your attribution data. Every dashboard load reads Northbeam again.

Revoke access anytime

Delete the key in Northbeam and Porter’s access ends at once. You can connect a new key later.

Setup

How to set up the Northbeam MCP server

Porter’s Northbeam MCP uses one server URL in every AI client, plus a Northbeam API key and Data-Client-ID you paste once. Claude takes Porter as a plugin or a custom connector. ChatGPT takes it through the Porter Metrics app or a custom MCP server. Both read the same Northbeam clients, with the same fields.

https://mcp.portermetrics.com/mcp

How to install Northbeam MCP in Claude

Open claude.ai and go to Settings → Connectors.
Click Add custom connector.
Name it Porter and paste https://mcp.portermetrics.com/mcp.
Click Add, then sign in with your Porter account and approve access.
Connect Northbeam when Porter asks: paste your Northbeam API key and Data-Client-ID.
Ask a Northbeam question, like “Show Spend and ROAS by Platform (Northbeam) for last week on Clicks + Modeled Views, 7-day window, accrual.”

On Team and Enterprise plans, an owner adds the connector first. Anthropic’s custom connector guide covers the same steps.

Create the API key in Northbeam

Open Settings → API Keys in Northbeam.
Choose Create new API key.
Copy the key and your Data-Client-ID.
Paste both into Porter’s Northbeam form, with a client name you’ll recognize.

Watch the Claude setup demo

How to install Northbeam MCP in ChatGPT

ChatGPT has two routes to the same data. The Porter Metrics app in ChatGPT’s app directory works on any plan with apps. The Porter MCP gets every new tool the day Porter ships it, on Business, Enterprise and Edu workspaces.

Porter Metrics app: in ChatGPT, open Apps, search “Porter Metrics”, click Connect and sign in with your Porter account, then connect Northbeam: paste your Northbeam API key and Data-Client-ID.

Porter MCP:

Open ChatGPT on the web and go to Plugins.
Click +, then Add custom MCP server.
Name it Porter and paste https://mcp.portermetrics.com/mcp under Connection.
Choose OAuth, tick “I understand and want to continue” and click Create as a plugin.
Sign in with your Porter account.

Pro accounts can add it with read access only, per OpenAI’s custom MCP server guide.

Watch the ChatGPT setup demo

How to install Northbeam MCP in Claude Code, Cursor, VS Code and Codex

Pick your coding agent. Each one uses the same server URL and a Google sign-in, so no API key or credentials file sits in a config.

Add Porter’s plugin in Claude Code. It installs the Porter connector and Porter’s skill in one step.
/plugin marketplace add portermetrics/porter /plugin install porter-metrics@portermetrics
Ask for your data. The first time, your browser opens: sign in with the Google account you use in Porter.
No plugins? Add the server directly instead:
claude mcp add --transport http porter https://mcp.portermetrics.com/mcp
Check: /mcp shows porter as connected. Ask: “Which Northbeam accounts can you see?”

Open Cursor Settings → Tools & Integrations and click New MCP Server. Cursor opens mcp.json.
Paste this and save.
{ "mcpServers": { "porter": { "url": "https://mcp.portermetrics.com/mcp" } } }
Click Connect next to porter and sign in with the Google account you use in Porter.
Check: porter shows a green dot in Tools & Integrations. Open an Agent chat. Ask: “Which Northbeam accounts can you see?”

Open the Command Palette (Ctrl/Cmd+Shift+P) and run MCP: Add Server → HTTP.
Paste https://mcp.portermetrics.com/mcp, name it porter and choose Global. Or add it to .vscode/mcp.json:
{ "servers": { "porter": { "type": "http", "url": "https://mcp.portermetrics.com/mcp" } } }
Allow the sign-in prompt and sign in with the Google account you use in Porter.
Check: open Copilot Chat in Agent mode; Porter’s tools appear under the tools icon. Ask: “Which Northbeam accounts can you see?”

Add Porter from your terminal.
codex mcp add porter --url https://mcp.portermetrics.com/mcp
Sign in. Your browser opens: sign in with the Google account you use in Porter.
codex mcp login porter
Check: codex mcp list shows porter as logged in. Start codex. Ask: “Which Northbeam accounts can you see?”

The same URL works in Windsurf, Cline, Zed and any client that supports remote MCP servers over HTTP.

Add Porter’s skill

Porter’s skill teaches Claude which Porter tools to call for each Northbeam task, so answers need fewer retries. In claude.ai, download https://mcp.portermetrics.com/skill.zip and upload it in Settings → Capabilities → Skills. In Claude Code, Porter’s plugin adds it for you, and other agents can run npx skills add portermetrics/porter.

Test the connection

Paste this into a new chat. It only reads data.

Use Porter only. List my connected Northbeam clients, then show Spend, Attributed Rev and ROAS by Platform (Northbeam) for the last 7 days on Clicks + Modeled Views, 7-day window, accrual accounting. Say so if an account returns no data.

Official Northbeam MCP server URL

Northbeam hosts its own server, included in every Northbeam plan:

https://mcp.northbeam.io

Northbeam’s guide to connecting Claude says each user signs in with their own Northbeam login and the connection is read-only. Use Porter’s URL for attribution next to Shopify and your ad accounts, with one key per client, live dashboards and scheduled emails.

Guides and videos

→

TutorialNorthbeam connector for Claude

→

TutorialNorthbeam connector for ChatGPT

Prompts

Northbeam MCP prompts

Copy a prompt into Claude or ChatGPT, then change the dates or thresholds to fit your account. Every prompt only reads data.

Reporting prompts

Models side by side

For the last 30 days, show Spend, Attributed Rev and ROAS by Platform (Northbeam) and Attribution Model, for Clicks-Only, Clicks + Modeled Views and Last Non-Direct Touch, 7-day window, accrual accounting. Which platforms change rank the most between models?

First-time CAC by platform

For the last 30 days on Clicks + Modeled Views, 7-day window, accrual, rank Platform (Northbeam) by CAC (1st time) and show Spend, Rev (1st time), Transactions (1st time) and Customers (New). Flag any platform whose CAC (1st time) is more than double the account’s.

LTV payback

For campaigns with Spend over $1,000 in the last 60 days on Clicks + Modeled Views, accrual, compare ROAS on the 7-day window with LTV ROAS and LTV CAC, and add Forecasted Attributed Rev (90d). Which campaigns look better on LTV than on 7 days?

Cash vs accrual

For last month on Clicks + Modeled Views, show Attributed Rev and ROAS by Platform (Northbeam) and Accounting Mode, 7-day window for accrual. Which platforms differ most between cash and accrual?

Ad-level winners

For the last 14 days on Clicks + Modeled Views, 7-day window, accrual, list the 10 Ads with the highest ROAS and Spend over $500, with Campaign and Ad Set.

Research and audit prompts

Northbeam vs Ads Manager

For the last 14 days, list Meta campaigns with Spend, ROAS on Clicks + Modeled Views, 7-day window, accrual, and FB ROAS (7D Click, 1D View). Sort by the gap between the two and explain the 3 largest gaps.

Attributed share of Shopify

For the last 8 weeks, show Northbeam Spend, Attributed Rev and MER by week on Clicks + Modeled Views, cash accounting, next to Shopify Total Sales by week. What share of Shopify sales does Northbeam attribute each week?

Spend check against Meta

For the last 14 days, put Northbeam Spend for Platform (Northbeam) Facebook Ads by Date next to Meta Ads Amount spent by Date on Clicks + Modeled Views, 7-day window, accrual. List the days they differ by more than 5%.

Client comparison

Compare every connected Northbeam client by Spend, Attributed Rev, ROAS and CAC (1st time) for the last 30 days on Clicks + Modeled Views, 7-day window, accrual, worst ROAS first.

The Shopify and Meta skills blend Northbeam with those accounts, so connect Shopify or Meta Ads in Porter first.

Management prompts

These run on a schedule and send what they find, while your Northbeam account stays as it is.

Monday attribution email

Build a Northbeam dashboard with Spend, Attributed Rev, ROAS and CAC (1st time) by Platform (Northbeam) and week for the last 8 weeks on Clicks + Modeled Views, 7-day window, accrual, and email it to me every Monday at 8 a.m.

Monthly LTV recap

On the 1st of every month, email my team a dashboard with last month’s Spend, LTV ROAS, LTV CAC and Forecasted Attributed Rev (90d) by Campaign on Clicks + Modeled Views, accrual.

Live client dashboard

Build a live Northbeam dashboard with Spend, Attributed Rev, ROAS and MER by Platform (Northbeam) for the last 90 days on Clicks + Modeled Views, 7-day window, accrual, and give me its link.

Who this is for

Media buyers and e-commerce marketers who move budget on attribution get the most from Porter’s MCP. Paid media teams, agencies, CMOs and marketing analysts use it to turn a Northbeam question into a model comparison, a first-time CAC ranking or an LTV payback check in one chat.

Paid media and growth marketers

Model check: which platforms only look good under one model, before you move budget.
First-time CAC: what a new buyer costs per platform, not a blended CAC returning buyers flatter.

Your CMO isn’t asking for Northbeam’s ROAS. They’re asking which channel to cut.

Agencies and freelancers

Every client in one chat: one prompt answers for all of them, with Client as a column.
Client reports: a live link the client opens on Monday, already current.

CMOs and marketing directors

One weekly table: attributed revenue next to Shopify sales, so the meeting starts from the same numbers.
Budget calls: spend, CAC and LTV ROAS by platform in one answer.

When to use Northbeam’s own instead

You want an assistant to read a specific order, list your saved Northbeam dashboards or see product-level attribution. Northbeam’s own server covers those jobs, and you can run it next to Porter.

Comparison

Official Northbeam MCP vs. Porter

Northbeam hosts its own MCP server at mcp.northbeam.io, included in every Northbeam plan. Northbeam’s MCP server FAQs say it reads the same data as the Northbeam dashboard, including performance, attribution, orders and product-level attribution when enabled. Porter covers attribution reporting and adds your other marketing sources, live dashboards and scheduled emails.

Northbeam’s MCP hands your AI your Northbeam dashboard. Porter’s MCP hands it your attribution next to the store and platforms it measures.

Both are hosted, both are read-only, and both answer spend, ROAS and attribution questions. Here is where they part.

	Porter	Northbeam’s MCP server
Same job, different reach
Server	Hosted by Porter at `mcp.portermetrics.com/mcp`	Hosted by Northbeam at `mcp.northbeam.io`
Sign-in	An API key and Data-Client-ID, pasted once in Porter	Each user signs in with their own Northbeam login
Data	Sales Attribution export: 647 fields by platform, campaign, ad set and ad	Dashboard data: performance, attribution, orders and product-level attribution when enabled
Models and windows	Every model, window and accounting mode as columns in one table	As your Northbeam dashboard shows them
Accounts	Every connected Northbeam client, compared in one answer	The dashboards your login can access; you name one per question
Price	Included in every Porter plan, the free plan too	Included in every Northbeam plan
Only one side
Shopify, Meta Ads and Google Ads in the same answer	Yes, from Porter’s 30+ data sources	—
Live dashboards at their own link	Yes	—
Scheduled reports by email	Yes	—
Single orders and saved dashboard views	—	Yes
Product-level attribution	—	Yes, when enabled

Northbeam’s column follows Northbeam’s MCP documentation (as of November 2026).

Use Northbeam’s own if you want orders, saved dashboards or product attribution in the chat. Porter’s rows under Only one side are what happens when attribution is one view among your store and ad numbers. Both servers can sit in the same Claude account.

Which Northbeam MCP do you need?

“Northbeam MCP” names a few different setups. The job decides which one you want.

Northbeam’s hosted server: your own Northbeam dashboards, orders and attribution in any AI tool with custom connectors.
Northbeam’s Data Export API: bulk exports and pipelines; MCP answers questions, it isn’t a data pipeline.
Porter: your Northbeam attribution next to Shopify and your ad platforms, in any MCP client.

And the third-party Northbeam MCPs?

Plenty of them rank for this search, and they split three ways.

Open-source servers: free to download and yours to host. You keep the key and patch it when Northbeam changes the API.
Connector directories: they wrap Northbeam’s API behind their own sign-in and billing.
API catalogs: they describe Northbeam’s API and leave the setup to you.

Porter reads Northbeam next to your marketing from one hosted server, starting on the free plan. Browse all marketing MCP servers Porter runs.

Porter vs other hosted Northbeam MCPs

Other hosted Northbeam MCPs also skip the setup. Porter is built for teams that report on several accounts and channels:

Every account at once

One prompt answers for all your Northbeam accounts and clients, not one account per setup.

Northbeam next to 30+ sources

GA4, Google Tag Manager, Google Ads, Meta Ads and Klaviyo, blended in one answer.

Competitor research

Competitor ads, keywords and search results, next to your own Northbeam numbers.

Reports outside the chat

Live dashboards, scheduled email reports, and the same data in Data Studio, BigQuery and Google Sheets.

Read-only by design

Porter reads Northbeam and changes nothing in it.

Claude and ChatGPT both covered

A remote MCP URL, plus an approved app in ChatGPT’s app directory.

Northbeam MCP pricing

The Northbeam MCP is included in every Porter plan, the free-forever plan too. Reporting is billed per connected account.

14-day trial: everything unlimited, no credit card.
Free forever: unlimited connected accounts, 30 days of history (15 days in AI chats), 100 automation credits a month.
Paid Reporting: from $15 per account a month, or $12.50 billed annually.
Unlimited questions: AI chats, queries and dashboards are included. Reads are free; each completed change uses 1 automation credit.

How many accounts will you connect?

5 accounts

Monthly billing

$40

Annual billing, per month

$33.33

Per account

$8.00

Reporting price for connected accounts, in USD. AI chats, queries and dashboards are unlimited. Annual billing is 10 months for 12.

The more accounts you connect, the lower the price per account. See the full calculator on Porter pricing.

Frequently asked questions

Is there an official Northbeam MCP?

Yes. Northbeam hosts its MCP server at https://mcp.northbeam.io, read-only and included in every Northbeam plan, with each user signing in with their own login. Porter's Northbeam MCP runs at https://mcp.portermetrics.com/mcp and puts Northbeam attribution next to Shopify and your ad accounts. You can connect both in Claude.

What is the Northbeam MCP server URL?

Porter's Northbeam MCP server URL is https://mcp.portermetrics.com/mcp, and Northbeam's own server is https://mcp.northbeam.io. Paste one into Claude, ChatGPT or another AI client as a custom connector. Porter's route takes a Northbeam API key and Data-Client-ID in Porter, while Northbeam's asks each user to sign in.

Is the Northbeam MCP free?

Porter's Northbeam MCP is included in every Porter plan, the free-forever plan too. The free plan covers unlimited connected accounts, up to 30 days of history, 15 days in AI chats and 100 automation credits a month. Paid Reporting starts at $12.50 a month per data source account, billed annually, and the 14-day trial needs no card.

Which attribution models and windows can Claude use?

Claude uses any of Northbeam's attribution models your export offers. Windows run 1, 3, 7, 14, 30 and 90 days plus LTV, and exist only in accrual accounting. Name the model in every prompt, and the window when you use accrual.

Can I connect several Northbeam clients?

Yes. Each Northbeam client, with its own API key and Data-Client-ID, connects and bills as one account. Agencies add each brand the same way, then ask one question across all of them. Claude tells the brands apart with the Client field.

Troubleshooting

Why don't the numbers match Northbeam?

Claude's numbers match the Northbeam dashboard when both use the same client, date range, timezone, attribution model, window, accounting mode and level. Recent days still shift while Northbeam processes orders, so compare a range that ends yesterday. Meta's own ROAS differs for reasons Northbeam's guide to ad performance discrepancies explains.

Why do Northbeam totals look too high?

Ask for one attribution model, window and accounting mode, or group by all three. Northbeam returns one row per combination and Porter passes every row to Claude, so adding them up counts the same revenue several times. Northbeam's accounting modes explain why cash and accrual differ.

Why does a Northbeam question take a minute?

Ask for several metrics in one question. Porter runs a Northbeam export for each question, which takes a few seconds to several minutes, and Northbeam allows 60 export requests per minute (Northbeam's Data Export API rate limits).

Start free

Connect Northbeam to Claude or ChatGPT and start with model comparisons, first-time CAC rankings and dashboards that land in your inbox.

Start free: unlimited connected accounts on the free-forever plan, or a 14-day trial with everything unlimited and no card.

Start free

Paid media and growth marketers: every model's view of each platform in one answer.
Agencies: every Northbeam client answers to one prompt.
CMOs: attributed revenue and Shopify sales in the same weekly table.
Marketing analysts: 647 named fields, counted once.