MCP connector

Pinterest keyword data inside ChatGPT and Claude

Ask your assistant how competitive a Pinterest keyword is, what ranks for it and what is rising, and it answers from pins we actually crawled. 15 lookups a month free, and a keyword we do not hold costs nothing.

1. Get your API key

Create an account, then open Settings → API in the dashboard and press Create key. The same key works for the REST API and here, and both draw on one monthly allowance.

Server URL: https://api.pinpinterest.com/mcp

2. Add it to your app

Claude Code

Run this once in your terminal, then ask Claude Code a Pinterest question.

claude mcp add --transport http pinpinterest https://api.pinpinterest.com/mcp \
  --header "Authorization: Bearer pp_live_YOUR_KEY_HERE"

Claude.ai & Claude Desktop

Settings → Connectors → Add custom connector.

Name it PinPinterest and paste this URL (with your key in place of the placeholder). Leave the OAuth fields empty.

https://api.pinpinterest.com/mcp?key=pp_live_YOUR_KEY_HERE

ChatGPT (developer mode)

Settings → Apps & Connectors → Advanced settings → turn on Developer mode.

Create a connector, paste this URL (with your key), and choose "No authentication" — the key in the URL is the authentication.

https://api.pinpinterest.com/mcp?key=pp_live_YOUR_KEY_HERE

Cursor

Add this to the file, then reload Cursor.

File: ~/.cursor/mcp.json

{
  "mcpServers": {
    "pinpinterest": {
      "url": "https://api.pinpinterest.com/mcp",
      "headers": {
        "Authorization": "Bearer pp_live_YOUR_KEY_HERE"
      }
    }
  }
}

VS Code (Copilot agent mode)

Add this to the file in your workspace, then start the server from the file.

File: .vscode/mcp.json

{
  "servers": {
    "pinpinterest": {
      "type": "http",
      "url": "https://api.pinpinterest.com/mcp",
      "headers": {
        "Authorization": "Bearer pp_live_YOUR_KEY_HERE"
      }
    }
  }
}

n8n

Add an MCP Client Tool node to your AI Agent and fill in these three fields.

Endpoint: https://api.pinpinterest.com/mcp
Server Transport: HTTP Streamable
Authentication: Bearer Auth → pp_live_YOUR_KEY_HERE

Replace pp_live_YOUR_KEY_HERE with your key. Keep a URL with your key in it private — anyone holding it can spend your lookups. You can revoke a key and make a new one at any time.

3. Ask

How competitive is "fall porch decor" on Pinterest, and is it worth a pin?
Give me ten related Pinterest keywords for "meal prep" with low competition.
Show me the top pins ranking for "capsule wardrobe" and what their titles have in common.
What are the most-saved video pins in home decor from the last 30 days?
What is rising in the food niche right now?
How many PinPinterest lookups do I have left this month?

The tools

Tool	What it answers
`keyword_lookup`	Pinterest data for one keyword: how many ranking pins we analysed, their average and total saves, competition (low/medium/high) and an opportunity score, plus its niche. est_clicks is an ESTIMATE derived from saves (Pinterest does not publish clicks or impressions for pins you do not own); pins_analysed, saves and competition are measured from the pins we crawled. A keyword we do not hold returns tracked:false with close suggestions and does not use a lookup.
`related_keywords`	Keywords that appear on the same ranking pins as yours, strongest overlap first — the ones worth targeting next. Each comes with how many pins it shares and its own competition. Needs the Starter plan or above.
`keyword_top_pins`	The best-performing pins ranking for a keyword, by saves, with their titles, links and save counts — what is winning that search right now. est_clicks is an ESTIMATE derived from saves (Pinterest does not publish clicks or impressions for pins you do not own); pins_analysed, saves and competition are measured from the pins we crawled. Needs the Pro plan or above.
`niche_top_pins`	The best-performing pins across a whole niche (use list_niches for the slugs), sorted and paged. Pass next_cursor back as cursor for the next page. There is no impressions sort: Pinterest does not publish impressions for pins you do not own, so we do not invent them. Needs the Pro plan or above.
`trending`	Topics rising in a niche right now, read from the pins people are publishing this month, with example pins. Use list_niches for the slugs.
`list_niches`	The niche slugs the other tools accept (niche_top_pins, trending). Free — uses no lookup.
`my_quota`	Your PinPinterest plan, how many lookups you have used this month and when they reset. Free — uses no lookup.

Each tool is a REST endpoint underneath, with the same numbers, the same plan rules and the same meter — see the allowance on each plan. When the month runs out, the assistant tells you, along with the plan that lifts the limit.

Get a key

Create an account, open Settings → API, press Create key. The free allowance never expires.