pinterest-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FFMPEG_PATH | No | Path to ffmpeg executable (default is assumed on PATH) for video download remuxing | |
| PINTEREST_COOKIE | No | Optional web session cookie for personalized resources (e.g., _pinterest_sess=...; csrftoken=...; _auth=1) |
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 for pins by keyword. Returns images, gifs, and/or videos with direct media URLs and a pagination bookmark. No authentication required. |
| pinterest_get_pinA | Fetch full detail for a single pin by id, including every image size and video stream. |
| pinterest_board_pinsB | List pins from a Pinterest board. Accepts a numeric board id or a 'username/board-slug' path. |
| pinterest_related_pinsA | Find pins related to a given pin id (visually/contextually similar). |
| pinterest_autocompleteA | Get Pinterest search-term suggestions for a partial query. |
| pinterest_downloadA | Download a pin's media (image, gif, or video) to local disk. Give a pinId to grab its best asset, or a direct media url. HLS videos are muxed to mp4 via ffmpeg. |
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 has a clear, distinct purpose: search, detail, board listing, related, autocomplete, and download. No two tools appear to overlap in functionality, making selection unambiguous.
All tools share the pinterest_ prefix, but the pattern is mixed: some are verbs (pinterest_search, pinterest_download), some are verb+noun (pinterest_get_pin), and some are noun+noun or adjective+noun (pinterest_board_pins, pinterest_related_pins). While readable, the lack of a uniform verb_noun structure is a minor deviation.
Six tools is well within the ideal range for a focused media search and retrieval server. Each tool earns its place and the count feels neither thin nor bloated.
The surface covers the core read-only workflows: searching, fetching details, listing board pins, finding related content, getting suggestions, and downloading media. Minor gaps like board metadata or user profiles exist, but they are not essential for the apparent purpose.