01 · Overview
What the Ryze AI Pinterest MCP server is
The short version
- 01Pinterest connects to a Ryze AI workspace through Pinterest’s own OAuth screen. Your AI client then connects to Ryze AI with one URL (see Setup).
- 02Two tools look (
listAccounts,read), one changes (write) and one deletes (delete). - 03They reach every ad account the login can open: campaigns, ad groups, ads and analytics, plus organic Pins and boards.
- 04Campaigns, ad groups and ads are archived, never deleted. Boards, Pins and audiences can be deleted.
- 05Works with any Ryze AI plan or trial. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (Pinterest Ads tools)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over HTTP
- Client sign-in
- OAuth to Ryze AI, up to 20 workspaces per connection
- Pinterest sign-in
- Pinterest OAuth, approve every permission, no keys to copy
- Pinterest API
- Pinterest API v5 (ads, Pins and boards)
- Pinterest tools
- 4 (2 read · 1 write · 1 delete)
- Also on this URL
- Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, Snapchat Ads, Reddit Ads, GA4, Search Console, Shopify
- Price
- Any Ryze AI plan or trial · Paid Ads $89/mo
- Checked
- November 8, 2026
“Pinterest MCP” covers two kinds of work, and the Ryze AI server does both. The ad side reads performance and manages campaigns through the Pinterest Ads API. The organic side creates Pins and boards. Pinterest’s own developer docs and GitHub organization list no MCP server of its own on Nov 8, 2026. The other options are third-party servers, most of them community projects that developers run on their own machines, compared in section 06.
01
Pinterest's own sign-in
You approve Ryze AI on Pinterest's OAuth screen with the login that reaches your ad accounts. There is no token to copy, and Ryze AI never sees your Pinterest password.
02
Every ad account the login reaches
There is no account picker. listAccounts returns each ad account the connected login can open, and the other tools take the account you name in the prompt.
03
Analytics through one read tool
pinterest_ads__read sends a GET to any Pinterest API v5 path, so ad account analytics, campaign lists and ad group lists all come from the same tool.
04
Ads and organic in one write tool
pinterest_ads__write creates and updates campaigns, ad groups and ads, pauses or archives them, and creates Pins and boards.
05
Deletes kept apart
Removing boards, Pins and audiences sits in pinterest_ads__delete, so you can allow edits and hold removals for approval. Campaigns, ad groups and ads are archived, never deleted.
06
More than one Pinterest login
Several Pinterest logins can sit in one workspace. A star marks the primary, Agent default accounts sets the accounts the agent uses first, and every tool takes an optional connection_id.
07
Pins from product URLs
Ryze AI can create Pins and boards from a chat, so a prompt can turn a list of product pages into Pins on a board you name.
08
Spend next to other platforms
Google Ads, Meta Ads and TikTok Ads tools answer on the same URL, so Pinterest cost per click can sit beside the same figure from another network.
02 · Tool reference
Four Pinterest tools and their inputs
All four take an optional connection_id to target one Pinterest login when a workspace holds several. Reads and writes go to Pinterest API v5 paths, so the agent works with the same resources Pinterest documents. Tool names come from the Ryze AI app source and were not confirmed against a live Pinterest connection on Nov 8, 2026.
| Tool | Access | What it does | Inputs |
|---|---|---|---|
pinterest_ads__listAccounts | read | Lists the Pinterest ad accounts the connected login can access. Pinterest counts accounts the login owns and accounts whose owners shared access through Business Access. | optional connection_id |
pinterest_ads__read | read | Reads any Pinterest API v5 resource: campaigns, ad groups, ads and ad account analytics such as spend, paid impressions, clicks and checkouts by day, week or month. | a v5 path such as ad_accounts/{id}/analytics · query · optional connection_id |
pinterest_ads__write | write | Creates or updates campaigns, ad groups and ads, including pausing and archiving, and creates Pins and boards. | a v5 path · method · body · optional connection_id |
pinterest_ads__delete | delete | Deletes edge resources such as boards, Pins and audiences. This cannot be undone. | a v5 path · optional connection_id |
How analytics reads work
There is no dedicated report tool. The agent calls read on the ad account analytics path and Pinterest returns the columns it asks for. These rules come from Pinterest’s API description for that endpoint.
| Date window | With DAY, WEEK, MONTH or TOTAL granularity, data reaches back 90 days from today (UTC) and one request covers at most 90 days. |
| Hourly data | With HOUR granularity, data reaches back 8 days from today (UTC). |
| Granularity values | TOTAL, DAY, HOUR, WEEK and MONTH. |
| Column names | Pinterest names reporting columns in capitals, for example SPEND_IN_DOLLAR, IMPRESSION_1, CLICKTHROUGH_1, CPC_IN_MICRO_DOLLAR, CPM_IN_DOLLAR, ECPC_IN_DOLLAR and TOTAL_CHECKOUT. |
| Who may read | The login must own the ad account or hold the Admin, Analyst or Campaign Manager role through Business Access. |
Source: Pinterest API description on GitHub, checked Nov 8, 2026. Other Ryze AI ad tools on the same URL are documented on Meta Ads MCP, Google Ads MCP and TikTok Ads MCP.
03 · Use cases
Prompts for Pinterest ads, Pins and boards
The prompts below use only what the four tools can do. Reads run freely. Anything that changes Pinterest goes through write or delete, so you can hold it for approval (see section 08).
- “Spend, clicks and cost per click by campaign for the last 30 days in every Pinterest ad account I can reach.”
- “Which ad groups spent money in the last 14 days with no checkouts?”
- “Compare this week with last week on Pinterest spend and checkouts, by day.”
- “Show Pinterest and Meta Ads cost per click for the same 30 days in one table.”
- “Which of my ad accounts has the highest Pinterest spend this month, and which campaign drives it?”
- “Put Pinterest and Google Ads spend side by side for the quarter and flag the larger one.”
- “List the ad groups I would pause for wasted spend. Do not change anything yet.”
- “Pause the three ad groups I confirm, then read them back to show the new status.”
- “Archive the campaigns I name that ended last quarter.”
- “Create a board called Autumn collection and a Pin for each of these 8 product URLs.”
- “List my boards and tell me which ones have no Pins.”
- “Create a Pin from this blog URL on the Gift guides board and show me the fields before saving.”
Every answer comes from your own ad accounts, so no sample numbers are shown here. Pinterest is a chat-only platform in Ryze AI: the Ryze AI help center lists it outside Managed Campaigns and the Ads Performance dashboard, so reports come from prompts to the read tool.
04 · Setup
Connect Pinterest once, then add the URL to each client
Step 1: link Pinterest in Ryze AI
- 01Open Integrations in the Ryze AI left sidebar and find Pinterest Ads with the Advertising filter or the search box.
- 02Click Connect, sign in with the Pinterest login that has access to your ad accounts and approve every permission.
- 03Back in Ryze AI the card shows Connected. There is no ad account to pick, because Ryze AI sees every ad account that login can reach.
- 04Optional: click View to choose Agent default accounts or to add one more account.
The steps are on the Ryze AI help center. From Claude or ChatGPT, the agent can also create a one-time connection link that opens the Pinterest sign-in.
Claude on the web or desktop
- 01Open Customize, Connectors, click + Add, then Add custom connector.
- 02Enter Ryze AI as the name and
https://connector.get-ryze.ai/mcpas the remote MCP server URL, then click Continue. Do not choose No sign in under Authentication, because the server needs OAuth. - 03Click Add, then Connect on the Ryze AI connector. On the Ryze AI page, sign in, choose the workspaces Claude can reach (up to 20) and click Allow connection.
- 04Start a new chat. Claude keeps the tool list from the moment the connector was added, so if you connected Pinterest Ads afterward, remove the connector, add it again and start a new chat.
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with one custom connector on Free. On Team, only Owners and Primary Owners can add one, and members then connect individually.
ChatGPT
OpenAI documents custom MCP servers as full access on Business and Enterprise or Edu, where an admin or owner creates and publishes the connection, and read and fetch only on Pro. In ChatGPT on the web, open Plugins, select the plus button, then Add custom MCP server. Name it Ryze AI, enter https://connector.get-ryze.ai/mcp as the public URL, choose OAuth, accept the risk warning and create it as a plugin. Sign in to Ryze AI, allow the workspace, install the plugin and type @ in a new chat to pick Ryze AI. Custom MCP servers cannot be connected on mobile. ChatGPT also exposes a legacy custom app path under Settings, Apps, which the Ryze AI help center documents. Write actions in ChatGPT may ask for confirmation.
Cursor
{ "mcpServers": {
"ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }Put the entry in ~/.cursor/mcp.json for every project or .cursor/mcp.json for one. Cursor runs OAuth with dynamic client registration, so sign in on the Ryze AI page and click Allow connection. The developer page also has an Add to Cursor link. Cursor asks for approval before it uses MCP tools by default.
05 · Permissions and scopes
Who can connect, and what Pinterest lets the token reach
| Who can connect | Any Pinterest login that can open the ad accounts. Pinterest lets the account owner, or a person with the Admin, Analyst or Campaign Manager role through Business Access, read ad analytics. |
| Which accounts | One connection covers every ad account that login can reach. More logins are added under View on the Pinterest Ads card with Add one more account, and a star marks the primary. |
| Older connections | A connection made before Ryze AI requested the Pin and board permissions cannot create Pins or boards until it is reconnected. |
| Pinterest scope | What it allows |
|---|---|
| ads:read | Read campaigns, ad groups, ads and ad account analytics |
| ads:write | Create and update campaigns, ad groups and ads, including pause and archive |
| user_accounts:read | Read the Pinterest account and the ad accounts it can reach |
| pins:read | Read Pins |
| pins:write | Create Pins |
| boards:read | Read boards |
| boards:write | Create boards |
The seven scopes are the ones the Ryze AI connection requests, from the Ryze AI help center and the app source, checked Nov 8, 2026. Pinterest’s consent screen shows the live list, so treat it as the source of truth.
Removing access
Pinterest lets you revoke an app from your Pinterest account settings. In Ryze AI, open View on the Pinterest Ads card to manage the logins. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.
06 · Compare
Ryze AI vs other Pinterest MCP options
What exists on Nov 8, 2026
| Option | Built for | How you connect | Pinterest data | Changes |
|---|---|---|---|---|
| Ryze AI hosted server | Advertisers and agencies who run Pinterest next to other ad networks | Pinterest OAuth in Ryze AI, then OAuth sign-in from the client | Ad accounts, campaigns, ad groups, ads, ad analytics, Pins, boards | Create, update, pause, archive, delete boards and Pins |
| Pinterest's own MCP server | None found on Nov 8, 2026 in Pinterest's API docs or its GitHub organization | None | None | None |
| terryso/mcp-pinterest (GitHub, community) | Developers who self-host | Runs on your machine; it scrapes public Pinterest pages with a headless browser and uses no Pinterest API credentials | Public image search and image details per its repository | See the repository |
| clugtu/pinterest-mcp (GitHub, community) | Developers who self-host | Runs on your machine with your own Pinterest credentials | Pins, boards and analytics per its repository | Create Pins and manage boards per its repository |
| collactivelabs/pinterest-mcp-server (GitHub, community) | Developers who self-host | Runs on your machine with your own Pinterest credentials | Pinterest API per its repository | See the repository |
Sources: Pinterest’s API description repository and a search of GitHub for Pinterest MCP repositories, checked Nov 8, 2026. The community rows describe each repository only at the level its listing shows. Read a repository’s tool list before you rely on it.
Community repositories in numbers
| Repository | Stars | License | Activity |
|---|---|---|---|
| terryso/mcp-pinterest | 52 stars | MIT | last push Nov 2, 2026 |
| collactivelabs/pinterest-mcp-server | 39 stars | no license listed | last push May 24, 2025 |
| clugtu/pinterest-mcp | 8 stars | MIT | last push Mar 12, 2026 |
GitHub figures as shown on Nov 8, 2026. They change daily.
Ryze AI and a self-hosted server side by side
| Ryze AI | Self-hosted community server | |
|---|---|---|
| Who sets it up | You, in the Ryze AI app and your AI client, with no code | A developer who clones the repository and runs it |
| Pinterest credentials | Pinterest OAuth sign-in, no keys to copy | Your own Pinterest app and tokens, kept by you |
| Ad campaigns | Read, create, update, pause and archive | Varies by repository; check its tool list |
| Organic Pins and boards | Create Pins and boards, delete boards and Pins | Varies by repository |
| Several ad accounts | Yes, every account the login reaches, plus more logins | Depends on the repository |
| Other platforms in the same chat | Google Ads, Meta Ads, TikTok Ads and more on one URL | Pinterest only |
| Maintenance | Ryze AI maintains the connector | You track the repository and Pinterest API changes |
| Price | Any Ryze AI plan or trial. Paid Ads $89/mo, 7-day free trial | Free to run, plus your own hosting and time |
The community column is general, because each repository differs. Check its README.
Which to pick: if you want to read or change Pinterest ads without hosting anything, or compare Pinterest with Meta Ads or Google Ads in one chat, use Ryze AI. If you are a developer who wants full control over the code and your own Pinterest app credentials, a self-hosted community server fits, at the cost of maintaining it. Neither route changes what Pinterest allows: the API rules in section 07 apply to both.
07 · API limits
Pinterest limits an agent runs into
| Analytics window | Pinterest returns up to 90 days of daily, weekly, monthly or total data per request and 8 days of hourly data, counted back from today in UTC. |
| Reporting roles | A login needs to own the ad account or hold the Admin, Analyst or Campaign Manager role to read analytics or list campaigns. |
| Archive instead of delete | Pinterest campaigns, ad groups and ads move to the ARCHIVED status. Ryze AI offers no delete for them. |
| 429 responses | Every Pinterest endpoint can answer 429 when the app sends too many requests in a given time. Ask the agent for fewer, broader reads, such as one analytics call for an account instead of one per campaign. |
| Request-rate numbers | Pinterest publishes its per-endpoint request limits in its developer documentation. This page does not repeat them, because the documentation page did not load for a page check on Nov 8, 2026. |
| Pins and boards after an upgrade | Connections made before the Pin and board permissions were requested need a reconnect first. |
| Client plans | Claude: any plan, with one custom connector on Free. ChatGPT: Business and Enterprise or Edu with full access, Pro with read and fetch only (OpenAI). |
From Pinterest’s API description on GitHub, the Ryze AI help center and the client vendors’ docs, checked Nov 8, 2026.
08 · Approvals and safety
How you keep control of edits
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, leave the read tools on automatic and set write and delete to Needs approval. Claude then shows each change and waits.
Approvals in the Ryze AI app
The Tool approvals setting in the Ryze AI chat starts on Skip all approvals, so the agent runs read, write and delete tools without asking. Switch it in the composer to Approve write & delete, or to Manual approve for every tool that touches your data.
Deletes kept separate
Only pinterest_ads__delete removes boards, Pins and audiences, and it cannot be undone. Campaigns, ad groups and ads are archived through write, which keeps them readable.
Pause before you archive
Pausing and archiving both go through the write tool. Ask the agent to list what it would change first, then approve the list.
Name the ad account
With several logins in one workspace, the default accounts answer unless the prompt names another. Agencies can keep one Ryze AI workspace per client.
Policies
Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.
09 · Errors and fixes
Pinterest MCP errors and fixes
| Message or symptom | Cause | Fix |
|---|---|---|
| Pinterest tools are not in Claude or ChatGPT | Pinterest Ads was connected after the connector was added, and the client kept the old tool list. | In Claude, remove Ryze AI under Customize, Connectors, add it again and open a new chat. In ChatGPT, remove the app, add it again and start a new chat. |
| Tools reply that a subscription is required | The workspace has no active Ryze AI plan or trial. | Start a plan or trial under Organization Settings, Billing, then retry. |
| An ad account is missing from the list | The connected login does not have access to it, or it belongs to another Pinterest login. | Ask the account owner to share it through Business Access, or add the other login under View, Add one more account. |
| Answers come from the wrong ad account | Several logins or ad accounts are connected and the default answered. | Name the ad account in the prompt, or set Agent default accounts under View on the Pinterest Ads card. |
| Creating a Pin or board fails | The connection was made before the Pin and board permissions were requested. | Reconnect Pinterest Ads in Ryze AI and approve every permission. |
| The Pinterest connection stopped working | The token was revoked or the permissions changed on Pinterest. | Reconnect Pinterest Ads from the Integrations page and approve again. |
| Hourly data stops after a week | Pinterest keeps 8 days of hourly data. | Ask for daily data when the question covers more than 8 days. |
| A date range over 90 days fails | Pinterest caps one analytics request at 90 days. | Ask for the range in 90-day pieces and have the agent join them. |
| The agent cannot delete a campaign | Pinterest ad entities are archived, not deleted, and Ryze AI follows that. | Ask the agent to archive it. |
The Ryze AI rows come from the Ryze AI help center and app source, and the date rules come from Pinterest’s API description. More Ryze AI answers are in the integrations FAQ.
10 · FAQ
Pinterest MCP server questions
What is a Pinterest MCP server?
An MCP server lets AI clients such as Claude, ChatGPT and Cursor call Pinterest through tools. The Ryze AI server has 4 Pinterest tools (listAccounts, read, write and delete) that work with ad accounts, campaigns, ad groups, ads, analytics, Pins and boards, on the same URL as its Google Ads and Meta Ads tools.
Does Pinterest have an official MCP server?
On November 8, 2026 Pinterest's API docs and its GitHub organization listed none that we could find. Pinterest does publish its API v5 description on GitHub. Most MCP servers found on GitHub are community projects, such as terryso/mcp-pinterest, clugtu/pinterest-mcp and collactivelabs/pinterest-mcp-server, which developers run on their own machines.
What is the Pinterest MCP server URL?
The Ryze AI server is https://connector.get-ryze.ai/mcp, the same URL for every account and every platform, with no client ID or token to enter. Pinterest connects separately inside Ryze AI through Pinterest’s sign-in.
How do I use Pinterest with Claude?
Connect Pinterest Ads on the Integrations page in Ryze AI, then in Claude open Customize, Connectors, Add custom connector, paste https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat. If you connected Pinterest after adding the connector, remove it, add it again and open a new chat so Claude reloads the tool list. Every client is covered in the setup section.
Can ChatGPT connect to Pinterest?
Yes, through the Ryze AI connector. OpenAI documents custom MCP servers as full access on Business and Enterprise or Edu, where an admin or owner sets them up, and read and fetch only on Pro. Add https://connector.get-ryze.ai/mcp under Plugins with OAuth, sign in to Ryze AI and allow the workspace. Custom MCP servers cannot be connected on mobile.
Which Pinterest tools does the AI get?
listAccounts lists the ad accounts the login can access. read sends a GET to any Pinterest API v5 path, including campaigns, ad groups, ads and ad account analytics. write creates and updates campaigns, ad groups, ads, Pins and boards and handles pausing and archiving. delete removes boards, Pins and audiences.
Can the AI delete Pinterest campaigns?
No. Campaigns, ad groups and ads are archived, not deleted, and archiving goes through the write tool. The delete tool covers boards, Pins and audiences only, and it cannot be undone. In Claude, set write and delete tools to Needs approval so each change waits for you.
Can it create Pins and boards, or only manage ads?
It does both. The write tool creates Pins and boards, and a prompt can turn a list of product URLs into Pins on a board you name. A connection made before Ryze AI requested the Pin and board permissions cannot create them until you reconnect Pinterest Ads and approve every permission.
Which Pinterest permissions does the connection need?
The Pinterest sign-in asks for ads:read, ads:write, user_accounts:read, pins:read, pins:write, boards:read and boards:write, and you approve all of them. Pinterest also requires that the login owns the ad account or holds the Admin, Analyst or Campaign Manager role through Business Access to read analytics and campaigns.
Can I connect more than one Pinterest ad account or login?
Yes. One login already covers every ad account it can reach. For more logins, open View on the Pinterest Ads card and click Add one more account. A star marks the primary, and Agent default accounts sets which accounts the agent uses first. Name any other account in the prompt.
How far back can the AI read Pinterest analytics?
Pinterest's API description says daily, weekly, monthly and total data reach back 90 days, with one request covering at most 90 days, and hourly data reaches back 8 days, all counted from today in UTC. For longer questions the agent has to split the range into pieces of 90 days or less.
Is the Pinterest MCP server free?
Adding the Ryze AI connector costs nothing, but its tools need a Ryze AI plan or trial: Paid Ads $89/mo with a 7-day free trial, or Agency $279/mo, with 30% off the first year on annual billing. Self-hosted community servers are free to run, and you provide your own hosting and Pinterest credentials. See the pricing page.
Which is the best Pinterest MCP server?
Ryze AI is the best Pinterest MCP server for comparing Pinterest ads with Meta Ads, Google Ads and TikTok Ads in one chat without hosting anything, though it is a paid hosted service and a developer who wants full code control may prefer a self-hosted community server. Ryze AI publishes this page.
11 · Compatibility
Where the Pinterest tools run
12 · Related
Other integrations and guides
Changelog
Page checked Nov 8, 2026. First version. The Pinterest tool names, setup steps, scopes and approvals were checked against the Ryze AI help center and app source. The analytics rules come from Pinterest’s API description, and the community servers from their GitHub pages. Client steps come from Anthropic, OpenAI and Cursor documentation.