moodboard-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PINTEREST_SANDBOX | No | Use api-sandbox.pinterest.com. | false |
| MOODBOARD_MCP_HOME | No | Where the token file is stored. | ~/.moodboard-mcp |
| PINTEREST_CLIENT_ID | No | Your Pinterest App ID. | |
| PINTEREST_ACCESS_TOKEN | No | Optional static token (skips OAuth), handy for quick testing. | |
| PINTEREST_CLIENT_SECRET | No | Your Pinterest App secret. | |
| PINTEREST_REDIRECT_PORT | No | Local port for the OAuth callback. Must match your app. | 8085 |
| PINTEREST_AUTH_BROKER_URL | No | Hosted login service. Set to "none" to disable. |
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
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pinterest_loginA | Starts the official Pinterest OAuth login (needed only for the user's own private/secret boards and search; public boards work without it via get_public_board). Opens the Pinterest consent page in the browser and waits briefly for approval. If approval takes longer, returns the URL; call pinterest_auth_status afterwards. |
| pinterest_auth_statusA | Shows whether the user is logged in to Pinterest and which account is connected. |
| pinterest_logoutB | Deletes the locally stored Pinterest token. |
| get_public_boardA | Reads any PUBLIC Pinterest board or profile from its link, with no login or keys. Returns the latest ~25 pins, with images attached so the model can see them. Accepts board URLs on any Pinterest domain, pin.it short links, or 'username/board-name'. Prefer this tool when the user shares a board link. |
| list_boardsB | Lists the logged-in user's Pinterest boards (id, name, pin count). |
| get_board_pinsA | Gets pins from a board. With include_images=true, the actual images are returned so the model can see the designs (use this for UI/visual inspiration). |
| get_pinB | Gets one pin's details and (optionally) its image. |
| search_my_pinsB | Searches the pins the logged-in user has saved (not all of Pinterest — the public search API needs special partner access). |
| extract_design_tokensA | Analyzes the images on a board (public board link, logged-in board id, or a list of pins) and returns a color palette with roles (background, surface, text, muted, accent), WCAG contrast ratios, CSS variables and a Tailwind colors snippet. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| moodboard_to_ui | Study a Pinterest board and build a UI in the same visual style. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool has a recognizable focus, but get_board_pins and get_public_board both return board pins with images and could be confused until the agent reads that one requires login and the other takes a public URL. The three auth tools (login/status/logout) are cleanly separated and extract_design_tokens is unmistakable.
Most tools follow a clear verb_noun snake_case pattern (list_boards, get_pin, search_my_pins, get_public_board, extract_design_tokens). The auth trio deviates with a pinterest_ prefix and noun-verb order, but it is internally consistent and still readable.
Nine tools is well within the ideal range and every tool maps to a distinct step in the read/extract workflow. Nothing feels redundant or padded.
The read path is solid (list boards, fetch pins, public boards, search, token extraction), but a moodboard server lacks any write operations — no create_board, save_pin/save_to_board, or pin creation — so agents cannot actually curate a moodboard. This is a notable gap rather than a fatal one since the stated purpose leans toward inspiration gathering.