# Pinterest MCP

> Pinterest MCP Server gives your AI client full command over visual marketing. Use it to manage boards, create pins, and pull detailed performance metrics without ever leaving your chat window. You can list all managed boards, generate new pins with optimized descriptions, or check top-level account stats like total impressions and save rates. It treats Pinterest as a data source you can query directly via natural language commands.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** visual-discovery, content-scheduling, audience-engagement, digital-marketing, board-management

## Description

You don't gotta mess around in the Pinterest dashboard trying to figure out what you need—your agent handles all that heavy lifting. This server gives your AI client full, direct command over every part of your visual marketing efforts on Pinterest. You can manage boards, drop new pins, and pull detailed performance metrics without ever leaving your chat window.

**Board Structure & Management**

You've got total control over your profile's organization. Use the `list_boards` tool to see every single board you manage right now. If you need to check out what’s on a specific one, run `get_board_info` for detailed metadata confirmation. Need to clear house? You can delete an entire board structure using `remove_board`. Furthermore, if you're organizing content, `list_pins_on_board` lets you pull an inventory of every pin attached to any given board.

**Content Creation & Organization**

Creating and maintaining content is simple. You can launch a brand new board on your Pinterest profile using `create_board`. To post something fresh, use the `create_new_pin` tool; just feed it the media source JSON input, and it'll drop the pin onto the exact board you specify. When you change your mind about content, `remove_pin` lets you take a specific pin right off its current board location. You can also get deep info on any individual piece of content by running `get_pin_details`, which pulls all available data points for that single pin.

**Analytics and Performance Tracking**

This is where the real money is made—the metrics. Don't guess how well your content does; let us show you the numbers. Run `get_account_performance` to pull high-level stats, giving you an overview of total reach or overall profile metrics for the whole account. For deeper dives into specific assets, `get_pin_performance` checks granular data on any pin, showing things like views, saves, and click-through rates. If you want to know what's hot right now, `list_top_performing_pins` automatically identifies and lists your best content across your entire history. You can also check out general profile information with `get_profile_info`. When you need to review a single piece of work, `get_pin_details` provides all the nuts and bolts on that pin's performance.

**Putting It All Together**

This setup means your AI client acts like a dedicated social strategist. You can list *all* boards you manage with `list_boards`, then check out the performance of every single top-performing pin using `list_top_performing_pins`. The process lets you treat Pinterest as a direct data source, querying it via natural language commands instead of clicking through dashboards. You'll never have to manually navigate or scroll anymore. It’s all about specific actions: creating content with `create_new_pin`, checking the structure with `get_board_info`, and analyzing results immediately using `get_account_performance`. This gives you a complete feedback loop, letting you optimize your visual marketing strategy on the fly.

## Tools

### create_board
Creates a brand new board on your Pinterest profile.

### create_new_pin
Posts a new pin to a specified board, requiring media source JSON input.

### remove_board
Deletes an entire board from your profile.

### remove_pin
Removes a specific pin from its current board location.

### get_account_performance
Retrieves overall account metrics and top-level performance statistics.

### get_board_info
Gets detailed metadata for a specific board, confirming its structure and status.

### get_profile_info
Gets general account information about the profile owner.

### get_pin_performance
Checks detailed stats for a specific pin, including views and saves.

### get_pin_details
Retrieves all available information about an individual pin.

### list_top_performing_pins
Identifies and lists the highest-performing pins across your account history.

### list_boards
Lists all the boards currently managed by your user account.

### list_pins_on_board
Retrieves a list of all pins contained within a given board structure.

## Prompt Examples

**Prompt:** 
```
List all my Pinterest boards.
```

**Response:** 
```
I've retrieved your boards. You have 3 active environments: 'Creative Inspiration', 'Product Catalog', and 'Marketing Assets'. Which one would you like to see pins for?
```

**Prompt:** 
```
Show me my top performing pins from the last 30 days ranked by engagement.
```

**Response:** 
```
Your top 5 pins by engagement this month. "Summer Home Decor Ideas" received 12,400 impressions and 847 saves (6.8% save rate). "Quick Healthy Recipes" hit 9,200 views with 623 click-throughs. "Modern Office Setup" drove 534 outbound clicks to your site. "DIY Garden Projects" generated 1,200 saves organically. "Travel Packing Guide" gained 890 repins. Total profile reach this month: 78,400 unique viewers.
```

**Prompt:** 
```
Create a new pin on my Home Inspiration board with the uploaded living room image.
```

**Response:** 
```
Pin created successfully on "Home Inspiration" board. Title: Modern Living Room Design. Description optimized for search with 5 relevant keywords. Link: points to your blog post. The pin is now live and discoverable. Pinterest suggests posting between 8-11 PM for this category to maximize reach. Estimated first-day impressions based on board followers: 2,400.
```

## Capabilities

### List & Delete Boards
See all boards you manage, retrieve their metadata, or delete an entire board structure.

### Create New Pins
Upload media and generate a new pin on a specific board with optimized titles and descriptions for better search visibility.

### Retrieve Account Performance Data
Get high-level stats, including total reach or overall profile metrics, using the `get_account_performance` tool.

### Check Pin Analytics
Pull granular performance data for individual pins, showing impressions, saves, and click-through rates via `get_pin_performance`.

### List Pins on a Board
Get an inventory of existing pins attached to any specific board using `list_pins_on_board`.

### Identify Top Content
Find the best-performing content automatically by listing your top performing pins via `list_top_performing_pins`.

## Use Cases

### Inventory Check Before Campaign Launch
You need to know exactly what assets are on your 'Fall Decor' board. Instead of clicking into the board, you tell your agent to run `list_pins_on_board` using the board ID. The agent immediately returns a structured list of all pins and their creators, letting you verify completeness before launching an ad campaign.

### Identifying Content Gaps
Your latest campaign is running low on inspiration. You ask your AI client to run `list_top_performing_pins`. The agent identifies that pins related to 'sustainable living' are underrepresented, giving you actionable data points for new content creation.

### Quick Profile Audit
The team needs a quick status report on the brand's overall visual reach. You instruct your agent to run `get_account_performance`. It returns key metrics—total impressions, unique viewers—allowing you to share an instant performance snapshot without leaving your chat interface.

### Removing Old Assets
The '2018 Summer Sale' board is obsolete. You tell the agent to run `list_boards` to confirm its existence, then use `remove_board`. It handles the deletion and confirms the cleanup in one step.

## Benefits

- Pin performance checks are instant. Instead of opening the analytics tab, you ask your AI client to run `get_pin_performance` and get saved metrics right away.
- Never manually track content again. Use `list_top_performing_pins` to immediately see what's working best across all your boards without clicking through multiple reports.
- Board setup is simple. Run `list_boards` to verify your entire visual identity is captured, or use `create_board` when you need a new category for assets.
- Content output is streamlined. Use `create_new_pin` and provide the media source; the agent handles optimization and posting directly to the target board.
- Analytics are centralized. Your AI client pulls account data using `get_account_performance`, giving you a single view of reach metrics without needing multiple dashboard logins.

## How It Works

The bottom line is: your AI client uses your token to execute specific actions on Pinterest for you and reports the results back to the conversation.

1. Subscribe to the server and provide your Pinterest OAuth Access Token from your developer settings.
2. Your AI client recognizes the available tools (e.g., `create_new_pin`, `list_boards`) and determines which action you need.
3. You simply instruct the agent via chat—'Check my best-performing pins last month.'—and it executes the necessary tool call, returning structured data.

## Frequently Asked Questions

**How do I find all my boards using list_boards?**
You simply ask your agent to run `list_boards`. It returns a complete, structured list of every board you manage, giving you the metadata and names immediately for planning or targeting.

**What is the difference between get_board_info and list_boards?**
`list_boards` gives you an inventory (a list) of all boards. `get_board_info`, however, fetches deep metadata for a single, specific board—like its last update date or total pin count.

**Can I track the performance of old pins with get_pin_performance?**
Yes. If you have a Pin ID or know which pin to check, your agent runs `get_pin_performance`. It retrieves the granular stats (impressions, saves) regardless of when the pin was posted.

**What tool should I use to post a new asset?**
Use `create_new_pin`. This tool requires you to provide media source JSON. The agent will prompt you for this data, and then it posts the pin directly to your chosen board.

**What should I do if `get_account_performance` fails due to an expired OAuth token?**
You must refresh your Pinterest developer credentials and update the access token on the Vinkius Marketplace. The server cannot pull performance data until the connection is validated with a current, active OAuth token.

**When using `create_new_pin`, what specific requirements does the media source need to be provided as JSON?**
The API requires the full media details packaged in a structured JSON object. This includes necessary image URLs and required descriptive metadata so the pin posts correctly and is fully discoverable.

**Does using `list_pins_on_board` provide every piece of information about the pins on that board?**
No, listing pins provides a summary count and basic titles. If you need to check specific stats or retrieve full metadata for any single pin, you must use the dedicated `get_pin_details` tool.

**How is deleting content managed when I run the `remove_board` tool?**
The board is deleted immediately and permanently from your account. Always confirm which board ID you are targeting before running this command, as there's no undo function for deletion.

**Can my AI automatically find the top-performing pins for a specific date range?**
Yes! Use the `get_top_pins_analytics` tool. Provide the start and end dates along with a sort criteria (like 'IMPRESSION'), and your agent will respond with complete metadata for your best content in seconds.

**How do I find my Pinterest OAuth Access Token?**
Log in to the [**Pinterest Developer Portal**](https://developers.pinterest.com/), create an application, and use the 'Token Generator' or perform the OAuth 2.0 flow to obtain your secret access token.