Pinterest MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_PINTEREST_PROXY | No | HTTP proxy (e.g. http://127.0.0.1:7890) to use when pinterest.com is unreachable; SOCKS is not supported | system HTTPS_PROXY |
| MCP_PINTEREST_LOCALE | No | Request locale | en-US |
| MCP_PINTEREST_TIMEOUT_MS | No | Per-request timeout in milliseconds | 20000 |
| MCP_PINTEREST_DOWNLOAD_DIR | No | Download root directory | ~/Downloads/pinterest-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pinterest_searchA | Search Pinterest pins by keyword (any language) for visual inspiration. Returns title, description, full-size image_url with width/height, dominant colour, source website, board and save count for each pin; video pins also get video_url (MP4) and video_seconds. Pins whose largest image is under 500px wide are marked low_res: true; skip them when you need a full-size reference. Set media to "video" for motion/interaction references. Promoted pins are filtered out. Use next_bookmark to page further. Tips: English keywords usually return more results; add words like "ui", "app", "dribbble", "poster", "moodboard" to steer the style. |
| pinterest_get_pinA | Get full details for one pin from its link or numeric id: full description, image, source website, board, creator, saves, comments. Anonymous search ids (e1_…) cannot be looked up — their data is already in the search result. |
| pinterest_related_pinsA | Find pins visually and topically similar to a given pin ("More like this"). Needs a real pin link or numeric id. |
| pinterest_board_pinsA | List the pins saved on a public board, e.g. one found in a search result's board.url. Accepts a board URL (pinterest.com///) or "/". |
| pinterest_preview_imagesA | Fetch small thumbnails of pin images (image_url values from other tools) so you can see them. Up to 16 at a time. |
| pinterest_downloadA | Save pin images (image_url) and videos (video_url MP4s) to disk; images at full resolution, falling back to 736px when the original is unavailable. Default location: /root/Downloads/pinterest-mcp/. Returns the saved file paths. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool addresses a distinct retrieval mode: keyword search, single-pin lookup, similarity lookup, board listing, thumbnail preview, and file download. The descriptions explicitly state dependencies and constraints (e.g. anonymous e1_ ids cannot be used with get_pin, preview vs download), leaving little room for misselection. Search/related/board_pins all return pins but differ clearly by input source and intent.
All tools share a consistent pinterest_ prefix and snake_case formatting. However, only get_pin and download use a verb-first pattern; search, related_pins, and board_pins read as noun phrases, so the verb_noun convention is not uniform.
Six tools is tightly scoped for a read-only inspiration/research server, with each tool covering a distinct step in the discover → inspect → preview → save workflow. No redundant or filler tools.
The core lifecycle (search, detail, similar, board browsing, visual preview, download) is fully covered with pagination via next_bookmark. Minor gaps exist for board/user-level discovery (no search for boards or pinners, no profile pin listing), which agents must work around by finding board URLs in search results.