# Pinterest Ads setup

> Connect Pinterest Ads to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 31 tools behind the answers.

[Guides](https://www.getmcpads.com/guides)

## For you

Delivery and catalogue reporting, targeting analytics, audience insights, billing.

## Connect it

1. Open the dashboard and choose this platform.
2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
3. Tick the accounts to expose. Nothing is readable until you do.
4. Paste the endpoint into your assistant, or use the shared one for every platform at once.

Pinterest Ads on its own endpoint

```text
https://mcp.getmcpads.com/pinterest-ads/mcp
```

## What to ask

```text
Break performance down by product group and by SKU.
Who is the audience actually reaching?
Which campaigns are pacing past their spend cap?
What does Pinterest itself publish as available metrics?
```

## What answers each one

| Question | Tools |
| --- | --- |
| Break performance down by product group and by SKU. | [`pinterest_run_catalog_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_catalog_report), [`pinterest_run_conversion_product_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_conversion_product_report) |
| Who is the audience actually reaching? | [`pinterest_get_audience_insights`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_audience_insights) |
| Which campaigns are pacing past their spend cap? | [`pinterest_run_report`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_run_report), [`pinterest_get_account_entities`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_account_entities) |
| What does Pinterest itself publish as available metrics? | [`pinterest_get_delivery_metrics`](https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_get_delivery_metrics) |

## What it can change

Pause, resume or archive a campaign or ad group. Change a campaign or ad group budget. Create a campaign, always paused.

> **Warning** 5 write tools, absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm before anything changes.

- [Pinterest Ads reference](https://www.getmcpads.com/docs/sources/pinterest-ads): All 31 tools, with their parameters.
- [Metrics](https://www.getmcpads.com/docs/sources/pinterest-ads/metrics): 91 metrics you can request.
- [Dimensions](https://www.getmcpads.com/docs/sources/pinterest-ads/dimensions): 36 ways to break a report down.
- [Skills](https://www.getmcpads.com/skills): 34 operating procedures use this source.

## For your agent

|  |  |
| --- | --- |
| Platform id | `pinterest_ads` |
| Tool prefix | `pinterest_` |
| Account parameter | `adAccountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/pinterest-ads/mcp |
| Tools | 31, 5 of which write |
| Announced by default | `pinterest_get_account_entities`, `pinterest_get_delivery_metrics`, `pinterest_health_check`, `pinterest_list_ad_accounts`, `pinterest_run_report` |
| Metrics | 91, see /docs/sources/pinterest-ads/metrics |
| Dimensions | 36, see /docs/sources/pinterest-ads/dimensions |

## Scope requested from the platform

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `ads:read` | Read Pinterest campaigns, ad groups, ads and analytics. | No |
| `ads:write` | Pause, resume and change budgets on Pinterest campaigns. Only reachable on a paid plan. | Yes |

## Reaching a tool that is not announced

```text
search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks
```

## What will refuse you

- An account not ticked by the owner. Call `list_accounts` and use a `adAccountId` from it.
- A write on a plan without writes. The tool is absent from the list and refused if called anyway.
- A write without `confirm: true` returns a preview and applies nothing. That is not an error.
- A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

## Questions this source answers

| Question | Tools, in order |
| --- | --- |
| Break performance down by product group and by SKU. | `pinterest_run_catalog_report` then `pinterest_run_conversion_product_report` |
| Who is the audience actually reaching? | `pinterest_get_audience_insights` |
| Which campaigns are pacing past their spend cap? | `pinterest_run_report` then `pinterest_get_account_entities` |
| What does Pinterest itself publish as available metrics? | `pinterest_get_delivery_metrics` |

---

This page as HTML: https://www.getmcpads.com/guides/sources/pinterest-ads
Every page under /guides and /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.