Free Pinterest MCP: No-Code Setup

Q: What is the Pinterest MCP server URL?

Porter's Pinterest MCP server URL is https://mcp.portermetrics.com/mcp. Pinterest's own server shows https://api.pinterest.com/mcp in its sample setup, for partners with access. Paste Porter's URL into Claude, ChatGPT or another AI client as a custom connector and sign in with Pinterest.

Free forever plan: unlimited connected accounts, up to 30 days of history (15 days in AI chats) and 100 automation credits a month.
Ready today: sign in with Pinterest, with no developer app and no early-access waitlist.
Run Pinterest Ads end to end: campaigns, pins, audiences, keywords and live dashboards.
Safe by default: new campaigns and ads start paused, and every change waits for your approval.

Try free

By Kashmala Malik · Last updated November 9, 2026 · All Pinterest Ads destinations

What is a Pinterest MCP server?

A Pinterest MCP server lets an AI assistant like Claude or ChatGPT reach your Pinterest data through the Model Context Protocol (MCP). You ask in plain language, and the assistant calls the Pinterest API for campaigns, ad groups, pins, audiences and keywords.

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: 365 Pinterest fields across campaigns, ad groups, pins, audiences and keywords
Changes: campaigns, ad groups, ads, pins, audiences, keywords and budgets, each after your approval; new campaigns start paused
Price: free plan, paid plans from $15 per account a month
Official Pinterest server: announced by Pinterest and in early access with alpha partners

Use cases

Pinterest MCP use cases

Porter Metrics connects Pinterest Ads to Claude, ChatGPT and other AI clients through one MCP server. Ask which pins send people to your site, which campaigns pay back or which audience to test next, and the answer comes from your live ad account.

Reports

Campaign management

Campaigns, ad groups and ads: build all three from a brief, with the objective, budget, bid and targeting you set.
Audiences: customer-list, website visitor, engagement and actalike audiences, ready to include or exclude in an ad group.
Multi-account and cross-channel: every ad account your Pinterest login reaches, next to Meta, Google and TikTok Ads. Start with the Meta Ads MCP.

Reporting and pin analytics

365 fields: spend, clicks, outbound clicks, engagement, video and conversions, all in the Pinterest Ads fields list.
Outbound clicks: Outbound Clicks and CPOC show which ads send people to your site, not only which ones get a tap.
Saves and engagement: Repin Rate, Total Engagement and Engagement Rate show which creative people keep.
Video: 3-second views, quartile views and average watch time per ad.
Live dashboards: one hosted link that stays current, with no export to rebuild.

Pins and boards

Organic pin results: Impression, Save and Clicks (Organic) for the pins on your boards.
Board inventory: Board Name, Board Total Pins and Pin Title for every board your login reaches.
New pins: Claude saves image, carousel or video pins to the board you choose, ready to post or promote.

Creative generation

Image and video: statics and short videos from a prompt or a product photo.
Voiceover: text to speech in the same conversation.
Straight into a pin: Porter saves the finished image or video as a pin on your board and adds it to a paused ad.

Research

Keywords: broad, phrase and exact keywords on ad groups, plus phrase and exact negatives on campaigns.

Management

Pins as the creative: image, carousel (2 to 5 images) or video pins saved to the board you pick, then promoted as ads.
Status and budgets: pause, enable or archive at any level, and change budgets, bids, schedules and targeting.
Pinterest tag: list your tags or create a new one, and Porter hands back the code snippet to install.
Return on spend: Add To Cart, Total Purchases (on conversion date) and Web Purchases Roas by campaign.
Scheduled reports: a dashboard emailed to you or a client on the day and hour you pick.
Pinterest Tag and audiences: create a conversion tag, then custom audiences from customer lists, site visitors, engagers or actalikes.

Example answer

Demo data, from a fictional account. Prompt: “Show my campaigns from the last 30 days with Ad Spend, Paid Impression, Outbound Clicks, checkouts and checkout value, with cost per outbound click and ROAS.”

Campaign Name	Ad Spend	Paid Impression	Outbound Clicks	Cost per outbound click	Checkouts	ROAS
Holiday gift guide	$2,410.00	1,250,000	9,840	$0.24	312	6.47
Home decor · Prospecting	$1,880.00	980,000	6,210	$0.30	141	4.50
Shopping · Catalog	$1,320.00	540,000	7,120	$0.19	268	10.15
Retargeting · Site visitors	$610.00	188,000	2,950	$0.21	122	10.00

Retargeting returns about $10 for every $1, so Claude suggests raising its daily budget before the holiday peak.

Reference

Pinterest MCP server reference

One server, every ad account: Porter connects Pinterest Ads to the AI clients, fields and workflows paid social teams already use. The same Porter server URL works in Claude, ChatGPT and any MCP client that supports remote servers. Porter’s Pinterest actions call Pinterest’s API v5 directly, so Claude reads campaigns, ad groups, ads and pins as they stand right now.

AI clients

Only one AI app?

ClaudePinterest connector

ChatGPTPinterest connector

Pinterest Ads fields

Account objects: ad accounts · campaigns · ad groups · ads · pins · boards · audiences · keywords · Pinterest tags

Campaign setup: Campaign Name · Campaign Daily Budget · Ad Groups Name · Ad Group Budget Type · Ad Name · Ad Status · Ad Review Status

Creative: Pin Title · Pin Id · Pin Type · Pin Url · Board Name

Pinterest Ads metrics

Delivery: Ad Spend · Paid Impression · Total Impression User · Total Impression Frequency · Cpc · CPOC

Clicks: Clicks · Outbound Clicks · Click-Through Rate · Total Page Visit · Cost Per Page Visit

Engagement: Total Engagement · Engagement Rate · Repin Rate

Video: Video Views · Video 3Sec Views · Video Views 25% · Video Views 50% · Video Views 75% · Video Views 95% · Video 100% Complete · Video Avg Watchtime In Second

Conversion: Add To Cart · Total Purchases (on conversion date) · Web Purchases Roas · Lead · Signup

Organic pins: Impression · Save · Save Rate · Clicks (Organic) · Engagement Rate (Organic)

Porter has 365 ready-made Pinterest Ads fields, 153 metrics and 212 dimensions. Each one is in the full Pinterest Ads field reference.

Dimensions and segments

Campaign: Account Name · Campaign Name · Ad Groups Name · Ad Name · Ad Type

Creative: Pin Title · Pin Type · Board Name

Keywords: Keyword · Keyword Matching Type

Time: Date · Week · Month · Quarter · Day of Week

Related MCPs

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

Other destinations

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

Each analytics answer covers up to 90 days, and hourly breakdowns cover 3 days within the last 8. Pinterest stores budgets and bids in micro-currency, so Claude turns $50 into 50,000,000 for you.

Security and trust

Safety and security

Porter’s Pinterest MCP signs in with Pinterest, creates new campaigns and ads paused and asks before anything changes in Ads Manager. Reporting, pin creation, drafting and budget changes are separate actions. An AI client working through Porter touches only as much of your Pinterest account as the task needs and you approve.

Reporting first

Ask about campaigns, pins and results without writing anything back to Pinterest. Reporting runs apart from changes, so a spend question never edits an ad group.

Reporting priced per account

Reporting is billed per connected Pinterest ad account. One more question about the same account adds nothing to the bill.

Pinterest sign-in, no developer app

Connect with your Pinterest login and pick the ad accounts Claude should reach. You skip registering a developer app, requesting API access and copying tokens.

Paused by default

Porter creates campaigns and ads paused, and Claude shows you the plan before it calls the create. Enable them when you’re ready: ad, then ad group, then campaign.

Budgets checked before they apply

Pinterest takes money in micro-currency, where one unit of your currency is 1,000,000. Claude converts the amount, shows it in your currency and waits for your yes. With campaign budget optimization on, the budget sits on the campaign.

Pins and archives are lasting

A new pin lives on the board you pick, like any pin you save yourself, and you remove it in Pinterest as usual. Archiving a campaign or ad group archives everything under it and can’t be undone, so Claude asks first.

Your Pinterest access decides what changes

Pinterest splits access into read and write permissions. Pinterest’s guide to API scopes lists ads:write, pins:write and boards:write for creating campaigns, pins and boards, so a login without them can only report.

Setup

How to set up the Pinterest MCP server

Porter’s Pinterest MCP uses one server URL in every AI client, plus a Pinterest sign-in you complete 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 reach the same Pinterest ad accounts, pins and boards.

https://mcp.portermetrics.com/mcp

How to install Pinterest 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 Pinterest when Porter asks: sign in with Pinterest.
Ask a Pinterest Ads question, like “Show Ad Spend, Clicks and Outbound Clicks by Campaign Name for the last 7 days.”

On Team and Enterprise plans, an owner adds the connector first. Anthropic’s custom connector guide covers the same steps. The Claude-specific setup and use cases live on the Pinterest Ads connector for Claude page.

Watch the Claude setup demo

How to install Pinterest 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 Pinterest: sign in with Pinterest.

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.

The Pinterest Ads connector for ChatGPT page covers the ChatGPT side in full.

Watch the ChatGPT setup demo

How to install Pinterest 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 Pinterest 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 Pinterest 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 Pinterest 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 Pinterest 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 Pinterest 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 every Pinterest ad account I can access, then show Ad Spend, Clicks, Outbound Clicks and CPOC by Campaign Name for the last 7 days. Say so if an account returns no data.

Official Pinterest MCP server URL

Pinterest has announced its own server, the Pinterest MCP Server. Pinterest’s MCP developer page shows this URL in its sample setup:

https://api.pinterest.com/mcp

Pinterest’s Cannes 2026 announcement says it is building the server with alpha partners such as PMG, Dentsu and Havas. Everyone else joins Pinterest’s MCP interest form and hears back when early access opens. Use Porter’s URL to work with Pinterest Ads today, next to your other channels.

Guides and videos

→

TutorialHow to connect Pinterest Ads to Claude

→

TutorialHow to connect Pinterest Ads to ChatGPT

Prompts

Pinterest Ads MCP prompts

Copy a prompt into Claude or ChatGPT, then change the dates or thresholds to fit your account. Every change waits for your approval.

Reporting prompts

Outbound click check

For the last 30 days, by Ad Name, show Ad Spend, Paid Impression, Clicks, Outbound Clicks and CPOC. Calculate outbound click rate and rank the 15 ads with the most Ad Spend.

Saves vs site visits

For the last 30 days, by Campaign Name and Ad Name, show Ad Spend, Total Engagement, Engagement Rate, Repin Rate and Outbound Clicks. List ads that people save but rarely click through.

ROAS by campaign

For the last 30 days, by Campaign Name, show Ad Spend, Add To Cart, Total Purchases (on conversion date) and Web Purchases Roas. Flag campaigns whose Web Purchases Roas sits below 2.

Video drop-off

For the last 14 days, by Ad Name, show Video Views, Video 3Sec Views, Video Views 25%, Video Views 50%, Video Views 75% and Video 100% Complete. Show where each video loses people.

Weekly trend

For the last 8 weeks, by Week and Campaign Name, show Ad Spend, Outbound Clicks and Total Purchases (on conversion date). Flag campaigns where CPOC rose two weeks in a row.

Research and audit prompts

Pinterest next to Meta

Compare my Pinterest Ads and Meta Ads accounts for the last 30 days: spend, clicks and purchases by platform and campaign.

Spend to sessions and orders

Put Pinterest Ad Spend by Campaign Name next to GA4 sessions and Shopify orders from the same campaigns for the last 30 days, by week.

Organic pins worth promoting

For the last 30 days, show Pin Title, Board Name, Impression, Save and Clicks (Organic) for my pins. Suggest three pins to promote and say why.

Interest targeting ideas

Look up Pinterest interest targeting options for home decor and list the ones that fit a furniture brand.

The spend-to-sessions skill blends Pinterest Ads with the GA4 connector for Claude and the Shopify MCP.

Management prompts

Pause weak ads

From the outbound click check, pause the ads I approve, and list each one before you change it.

Campaign from a brief

Create a paused Consideration campaign with a $40 daily budget and one ad group targeting the United States. Save the image I link as a pin on my ‘Spring launch’ board and promote it in one ad. Show me everything first.

Visitor and actalike audiences

Create a website visitor audience from my Pinterest tag for the last 30 days, then an actalike audience from it. Show me the plan before you create either.

Negative keywords

Add ‘free’, ‘diy’ and ‘printable’ as phrase negative keywords to my ‘Spring launch’ campaign. List them before you add them.

Pinterest tag

Create a Pinterest tag called ‘Store checkout’ and give me the code snippet to install on my site.

Who this is for

Marketers who build Pinterest campaigns as well as report on them get the most from Porter’s MCP. Agencies, paid social managers, e-commerce marketers and social media teams use it to turn a Pinterest question into a ranked report, a paused draft or a live dashboard in one chat.

Agencies and freelancers

Every client account: one question across every ad account your Pinterest login reaches, with Account Name as a column.
Client reports: a live dashboard the client opens on Monday that nobody rebuilt.

Your client isn’t asking about impressions. They’re asking which pins brought shoppers to the site.

Paid social managers

Outbound clicks: the ads that send traffic, not only taps.
Creative wear-out: rising CPOC flagged week by week.

E-commerce marketers

Purchases and ROAS: Web Purchases Roas by campaign, next to Shopify orders.
Pinterest tag: a new tag and its snippet in one prompt.

When to use Pinterest’s own instead

You’re one of Pinterest’s alpha partners, or you need Pinterest trends and audience insights inside your AI. Pinterest’s server lists those jobs, and you can run it next to Porter once you have access.

Comparison

Official Pinterest MCP vs. Porter

Pinterest’s own Pinterest MCP Server and Porter’s MCP both connect Pinterest to AI clients. Pinterest’s developer page describes searching Pins, managing Boards, trends and audience insights, and the server is open to alpha partners for now. Porter covers the Pinterest Ads job today and adds every other channel, dashboards and creative.

Pinterest’s MCP will hand your AI the Pinterest toolbox. The Porter MCP hands it the marketing job: every channel, the reporting, the creative and skills that already know the work.

Both are hosted, use one URL and sign in with OAuth, with no developer app of your own. Here is where they part.

	Porter	Pinterest MCP Server
Same job, different reach
Server	Hosted by Porter at `mcp.portermetrics.com/mcp`	Hosted by Pinterest at `api.pinterest.com/mcp`
Who can use it	Anyone with a Porter account, the free plan too	Alpha partners; everyone else signs up for early access
Sign-in	Pinterest login	OAuth 2.0 with granular permissions, per Pinterest
Campaign management	Campaigns, ad groups, ads, pins, audiences and keywords, created paused, approval before every write	Create, update and optimize, per Pinterest; no tool list published yet
Trends and audience insights	You check these in Pinterest as usual	Listed on Pinterest’s MCP page
Works in	Claude, ChatGPT, Cursor and any remote MCP client	Claude, Cursor and VS Code, per Pinterest
Price	Included in every Porter plan, the free plan too	No price listed
Only one side
Other channels	30+ data sources: Meta Ads, Google Ads, TikTok Ads, GA4, Shopify and more	—
Cross-channel in one conversation	Yes	—
Live dashboards at their own link	Yes	—
Scheduled reports by email	Yes	—
Image, video and voiceover generation	Yes	—
Data Studio, Google Sheets, BigQuery	Yes	—
Skills: whole Pinterest tasks, already written	Yes	—

Pinterest’s column follows Pinterest’s MCP developer page and its Cannes 2026 announcement (as of November 2026).

Use Pinterest’s own once you have access and need trends or audience insights. Everything under Only one side is what happens when Pinterest is one channel of several. Both connectors can sit in the same Claude account.

If Pinterest’s own server isn’t open to you yet

Pinterest’s developer page still asks visitors to sign up to hear when the server launches.

Nothing is wrong with your account: Pinterest is evolving its MCP with alpha partners first.
No published tool list: Pinterest’s page describes what the server does but doesn’t list its tools or limits yet.
The sample uses a token: Pinterest’s sample setup passes a bearer token in the request header.
Porter works now: sign in with Pinterest through Porter, paste Porter’s server URL and ask your first question.

And the other Pinterest MCPs?

Search for a Pinterest MCP and three other kinds show up. The job tells you which one you’re looking at.

Automation gateways: one or two generic actions, such as creating a pin, inside a wider automation tool.
Image search servers: open-source servers that search and download public Pinterest images, handy for mood boards rather than ads.
Open-source servers: free to download and yours to host. You keep the token and patch it when Pinterest changes the API.

Porter does the advertiser’s job from one hosted server, starting on the free plan. Browse all marketing MCP servers Porter runs.

Porter vs other hosted Pinterest MCPs

Other hosted Pinterest 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 Pinterest accounts and clients, not one account per setup.

Pinterest next to 30+ sources

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

Competitor research

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

Reports outside the chat

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

Changes with approval

Every Pinterest change is shown first and waits for your yes.

Claude and ChatGPT both covered

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

Pinterest MCP pricing

The Pinterest 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 Pinterest MCP?

Pinterest has announced the Pinterest MCP Server and is building it with alpha partners, with an early-access sign-up for everyone else. Porter's Pinterest MCP runs today at https://mcp.portermetrics.com/mcp and adds your other channels, dashboards and creative. You can connect both in Claude once Pinterest opens access.

What is the Pinterest MCP server URL?

Porter's Pinterest MCP server URL is https://mcp.portermetrics.com/mcp. Pinterest's own server shows https://api.pinterest.com/mcp in its sample setup, for partners with access. Paste Porter's URL into Claude, ChatGPT or another AI client as a custom connector and sign in with Pinterest.

Is the Pinterest MCP free?

Porter's Pinterest 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.

Can it create organic pins, or only ads?

Both. Claude saves image, carousel or video pins to the board you choose, and you can leave them as organic pins or promote them in a paused ad. Porter also reports Impression, Save and Clicks (Organic) for your pins, next to paid results from the same account.

Can I connect several Pinterest ad accounts?

Yes. One Pinterest login brings every ad account that user can reach, and you pick the ones Claude should use. Claude compares them in one answer with Account Name as a column. Reporting is billed per connected ad account, and the free plan connects unlimited accounts.

Can it search or download Pinterest images?

Porter works with your own Pinterest accounts: ads, pins, boards and their results. Searching and saving other people's public images is a job for an image search server, and you can run one next to Porter. For your own creative, Porter generates new images and saves them as pins.

Troubleshooting

Why don't the numbers match Pinterest Ads Manager?

Check the dates and the conversion clock first. Porter's analytics dates run in UTC, and fields marked "on conversion date" count a purchase on the day it happened, not the day of the click. Click, engagement and view windows also change conversion totals, so ask Claude to name the windows it used.

Why can't Claude create my Pinterest ad?

Check four things. Every pin needs a board, so pick one first. Sales and Leads campaigns need a Pinterest tag on your site. A new video pin needs a few minutes to process before it can be promoted. Your login also needs Pinterest's write permissions for ads, pins and boards.

Why did a long date range fail?

Pinterest analytics answers cover up to 90 days per question. Split a longer range into 90-day pieces and Claude adds them together. Hourly breakdowns cover up to 3 days within the last 8, so ask for daily data on anything older.

Start free

Connect Pinterest Ads to Claude or ChatGPT and start with outbound click reports, live dashboards and campaigns that wait for your approval.

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

Start free

Agencies: every client's Pinterest account answers to one prompt.
Paid social managers: outbound clicks, CPOC and the budget change sit in one chat.
E-commerce marketers: Pinterest spend next to store orders in one link.
Social media marketers: the best organic pin becomes a paused ad in one prompt.