How to Connect Porter Metrics to Claude with MCP: Complete Step-by-Step Guide (2026)

boltQuick answer

To connect Porter Metrics to Claude, install the MCP with claude mcp add --transport http portermetrics https://mcp.portermetrics.com/mcp (for Claude Code), or add https://mcp.portermetrics.com/mcp as a custom connector in Claude Desktop/Web. Sign in with OAuth and start asking questions about your marketing data.

What is the Porter Metrics MCP?

The Porter Metrics MCP is a Model Context Protocol server that lets Claude read your marketing data directly from Porter. Once connected, you can ask natural-language questions about any account you linked in Porter — Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Shopify, HubSpot, GA4, Search Console, and more — and Claude runs the query for you.

MCP (Model Context Protocol) is an open standard created by Anthropic that acts as a universal adapter between AI assistants and external tools. Any MCP-compatible client (Claude Desktop, Claude Web, Claude Code, Cursor, custom agents) can plug into the Porter MCP the same way.

Why it matters: instead of building dashboards or exporting CSVs, you describe what you want and Claude fetches, analyzes, and presents the answer in the same conversation.

Prerequisites: what you need before you start

Before you connect Porter to Claude, make sure you have the following ready:

An active Porter Metrics account with at least one data source connected (free trial available).
Claude Desktop, claude.ai (web), or Claude Code installed and signed in.
A Claude plan with tool use (included in all paid plans and the free tier for claude.ai).
~5 minutes to complete the full setup.

How to connect Porter Metrics to Claude Desktop or Claude Web

This is the easiest path for most marketers. Follow these 11 steps to add Porter as a custom connector in Claude Desktop or claude.ai. The flow is identical on both.

If you prefer to click through the setup at your own pace first, here’s the interactive walkthrough:

Open Claude and click the chat input

Launch Claude Desktop or open claude.ai in your browser. Click anywhere on the chat input field at the bottom of the screen.

Step 1 screenshot of Claude home screen with chat input

Click the + button to open the menu

Inside the chat input, click the + icon on the left. This opens the tools menu where Connectors live.

Step 2 screenshot of Claude chat input menu

Go to Connectors → Manage connectors

Hover over Connectors in the menu, then click Manage connectors to open the connector settings panel.

Step 3 screenshot of Manage connectors option

Click the + to add a new connector

In the Connectors panel, click the + icon at the top right of the connector list.

Step 4 screenshot of add connector button

Choose Add custom connector

From the dropdown, select Add custom connector to open the custom setup dialog.

Step 5 screenshot of Add custom connector option

Name your connector Porter

In the Name field of the dialog, type Porter so you can find it easily inside any conversation.

Step 6 screenshot of Name field with Porter

Paste the Porter MCP URL

In the Remote MCP server URL field, paste https://mcp.portermetrics.com/mcp — this is the official endpoint.

Click Add to save the connector

Click the Add button. Claude will open your browser so you can sign in to Porter and authorize access via OAuth.

Review the Porter tools Claude can use

Once connected, you will see Porter’s read-only tools: list_accounts, list_data_sources, list_fields, query_data and more. Go back to your chats when you are ready.

Ask Claude a question about your marketing data

Back in a conversation, write a prompt like: “Can you bring my GA4 website sessions by day during this month blended with Search Console clicks?”

Step 10 screenshot of Claude chat with prompt

See the response with real numbers and charts

Claude calls Porter, pulls the data, blends the sources you asked for, and returns a chart plus a short analysis. You are now chatting with your marketing data.

Step 11 screenshot of Claude response with chart

How to connect Porter Metrics to Claude Code (CLI)

If you use Claude Code in the terminal, the install is a one-liner. This is the recommended path for developers, technical marketers, and anyone automating with scheduled tasks.

Step 1 — Register the Porter MCP

Open your terminal and run the following command:

# Register Porter as an HTTP MCP server in Claude Code
claude mcp add –transport http portermetrics https://mcp.portermetrics.com/mcp

That registers the Porter MCP in your Claude Code configuration.

Step 2 — Authenticate with Porter

The next time you start a Claude Code session, Claude will open your browser and ask you to sign in to Porter. Complete the OAuth flow once and the connection persists across sessions.

Step 3 — Verify the connection

Inside Claude Code, run:

/mcp list

You should see portermetrics in the list with status connected. You’re ready to query your data.

How to verify the connection is working

Regardless of which client you used, the fastest way to confirm Porter is connected is to ask Claude a simple discovery question:

Try this: “Using Porter, list all the data source accounts I have connected.”

Claude should return a list of your accounts (e.g. Google Ads Account 1, Meta Ads Agency Account, GA4 Property). If you see the list, you’re done — the MCP is live and ready for real queries.

check_circleWhat a successful connection looks like

Claude will take a second to call list_accounts, then respond with a clean list grouped by platform. If you see an error or “no accounts found,” jump to the Troubleshooting section.

What you can do with Claude + Porter Metrics

Once connected, the Porter MCP unlocks these everyday marketing workflows:

bolt

Ask in plain English

“How much did we spend on Meta Ads last month by campaign?” — Claude runs the query and gives you the answer in seconds.

merge_type

Blend sources on the fly

“Compare Google Ads cost vs. GA4 revenue for the last 30 days.” Cross-source analysis without leaving the chat.

description

Quick reports & summaries

Ask Claude to summarize last week’s performance across all paid channels and drop a client-ready recap in Slack.

edit_note

Write with real data

Draft marketing docs, exec summaries, and QBR slides with live metrics pulled into the same conversation.

schedule

Automate recurring work

Pair it with Claude Code’s scheduled tasks to receive a Monday-morning KPI digest — unattended.

target

Diagnose performance dips

Claude spots the top 3 campaigns dragging down ROAS this week and explains why in a paragraph.

Example prompts to try

Copy any of these prompts into a new Claude conversation (with the Porter connector enabled) to see what the integration can do:

prompt_suggestion“Pull yesterday’s Meta Ads results grouped by campaign and ad set. Flag anything with CPA above $40.”

prompt_suggestion“Compare Google Ads vs. Microsoft Ads performance for Q1 — clicks, conversions, and CPC.”

prompt_suggestion“What were my top 10 organic landing pages in Search Console last 28 days? Include clicks, impressions, and average position.”

prompt_suggestion“From Shopify, what are my 5 best-selling products this month and how does that compare to last month?”

prompt_suggestion“Draft a short weekly report for my client using Google Ads spend, GA4 sessions, and Shopify revenue.”

prompt_suggestion“Which of my Meta Ads campaigns had the highest ROAS in the last 14 days? Group by campaign objective.”

prompt_suggestion“Show me TikTok Ads CPA trend for the last 8 weeks and highlight any anomalies.”

prompt_suggestion“Blend HubSpot deals with Google Ads spend and tell me which campaigns drove the most pipeline this quarter.”

Supported data sources and integrations

The Porter MCP covers the same 25+ data sources Porter supports in Looker Studio, Google Sheets, Power BI, and BigQuery:

Advertising

Google AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdsPinterest AdsReddit AdsX AdsApple AdsGoogle DV360

Analytics & SEO

Google Analytics 4Search ConsoleGoogle Business Profile

Social

Instagram InsightsFacebook InsightsLinkedIn PagesTikTok InsightsFacebook Public Data

E-commerce

ShopifyAmazon Seller

CRM & Email

HubSpotKlaviyoMailchimpActiveCampaign

Other

Google Sheets

Considerations, security, and limitations

Before you roll this out to your team or clients, here are the things worth knowing:

Authentication and data access

The MCP uses OAuth 2.0 to connect your Porter account. Every session is scoped to the accounts you authorized in Porter. Claude can’t see accounts that aren’t linked to your Porter workspace.

Read-only by design

All tools exposed by the Porter MCP are read-only — list_accounts, list_data_sources, list_fields, query_data. Claude cannot modify ad campaigns, pause budgets, or change any settings in your source platforms.

Data privacy

Your data never leaves Porter’s secure pipeline. Claude only receives the specific rows it requests, not your entire account. You can revoke the connector at any time from Claude Settings or from Porter → Integrations.

Rate limits and query size

Queries return up to 1,000 rows per request and respect each platform’s native API rate limits (e.g., Google Ads API quotas, Meta Graph API limits). For large exports or bulk data, use Porter’s Looker Studio, Sheets, or BigQuery connectors instead.

Heads up: The MCP is optimized for interactive analysis, not bulk data transfer. If you need to move millions of rows, use Porter’s BigQuery or Sheets destinations instead.

Cost

The MCP is included in every Porter plan, including the free trial. Claude usage follows your own Anthropic plan — there are no extra fees from Porter for MCP requests.

Troubleshooting common issues

If something isn’t working, check this list first:

errorOAuth window doesn’t open after clicking Add

Disable pop-up blockers for claude.ai and try again. On Claude Desktop, check that your default browser is set correctly in system settings.

error“No accounts found” when asking a question

Make sure you’re logged into the same Porter account that has the data source connected. Go to Porter → Data Sources and confirm the account is active.

errorClaude says it can’t access Porter

The connector may have been disabled. In Claude, go to Settings → Connectors, find Porter, and toggle it on. You may need to re-authorize OAuth.

errorQuery returns empty results

Check the date range — some platforms have a 48-hour data delay. Also verify the account has data for the metrics you’re asking about.

error“Invalid field” errors

Ask Claude to first list the available fields for that data source before running the query. Field names vary by platform.

errorSlow responses for large queries

Narrow the date range or filter to specific accounts/campaigns. MCP queries are capped at 1,000 rows per request for performance.

Still stuck? Contact Porter support and include the error message plus the prompt you tried.

Frequently asked questions

How do I connect Porter Metrics to Claude?

Install the Porter MCP either by running claude mcp add --transport http portermetrics https://mcp.portermetrics.com/mcp in Claude Code, or by adding it as a custom connector in Claude Desktop/Web using the URL https://mcp.portermetrics.com/mcp. Authorize via OAuth and you’re done.

Is the Porter Metrics MCP free?

The MCP is included with any active Porter Metrics plan, including the free trial. There’s no extra fee for using it with Claude, ChatGPT, or any other MCP-compatible client.

Does it work with Claude Code, Claude Desktop, and Claude Web?

Yes. Any client that supports remote HTTP MCP servers can connect — Claude Code, Claude Desktop, claude.ai on the web, and third-party tools like Cursor or custom agents built with the Anthropic SDK.

Which Claude model should I use for marketing analysis?

Any Claude model with tool use works. For complex multi-source analysis we recommend Claude Opus 4.6 or Claude Sonnet 4.6. Claude Haiku 4.5 is faster and handles most day-to-day marketing queries.

Can I use the Porter MCP with n8n, Zapier, or custom agents?

Yes. Anything that supports the Model Context Protocol can plug in. The MCP spec is open, so any agent framework — including the Anthropic SDK, OpenAI Agents SDK, or LangChain — can call it.

Is my marketing data safe when using the MCP?

Authentication uses OAuth and every session is scoped to your Porter account. Claude only sees the rows it explicitly asks for, limited to the accounts you authorized. All tools are read-only — Claude cannot modify, delete, or export anything outside the chat. You can revoke the connection at any time.

Which data sources are supported through the Porter MCP?

All 25+ data sources Porter supports elsewhere: Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, Pinterest Ads, Reddit Ads, X Ads, Apple Ads, Google DV360, GA4, Search Console, Google Business Profile, Instagram Insights, Facebook Insights, LinkedIn Pages, Shopify, Amazon Seller, HubSpot, Klaviyo, Mailchimp, ActiveCampaign, and Google Sheets.

Can Claude write back to my ad accounts or send reports?

No. The Porter MCP is strictly read-only. Claude can pull, analyze, and present your data — but it cannot change bids, pause campaigns, or push data out. For write operations you’d need a separate connector, which is not part of this integration.

Ready to chat with your marketing data?

Open Claude, add the Porter connector, and ask your first question. If you don’t have Porter yet, start a free trial and connect one data source — you’ll be talking to your data in under five minutes.

rocket_launchStart free Porter trial open_in_newOpen Claude