pinterest-mcp

Fetch the authenticated user's account: username, id, account type, profile image and follower counts. The fastest way to verify a token works. Scope: user_accounts:read.

Daily account-level analytics over a date window of up to 90 days. Scope: user_accounts:read and pins:read.

Rank the account's pins by a metric over a date window — the tool to reach for when asked what is working. Scope: user_accounts:read and pins:read.

Rank the account's video pins by a video metric over a date window. Scope: user_accounts:read and pins:read.

Daily analytics for a single pin over a date window of up to 90 days. Scope: pins:read.

Analytics for up to 100 pins in one call — far cheaper than looping pinterest_get_pin_analytics. Scope: pins:read.

List the accounts following the authenticated user. Scope: user_accounts:read.

List the users and boards the authenticated user follows. Scope: user_accounts:read.

List the websites claimed by the authenticated account, with their verification status. Scope: user_accounts:read.

List the authenticated user's boards, newest first. Scope: boards:read (plus boards:read_secret to include secret boards). Returns a `bookmark` cursor when more pages exist.

Fetch a single board by id, including its pin and follower counts. Scope: boards:read.

Create a new board on the authenticated account. Scope: boards:write (boards:write_secret for SECRET boards).

Update a board's name, description or privacy. Only the fields you pass are changed. Scope: boards:write.

Permanently delete a board AND every pin saved to it. This cannot be undone. Scope: boards:write.

List the pins saved to a board. Scope: pins:read and boards:read.

List the sections within a board. Scope: boards:read.

Add a section to a board. Scope: boards:write.

Rename an existing board section. Scope: boards:write.

Delete a board section. Pins in the section move back to the board root rather than being deleted. Scope: boards:write.

List the pins saved inside one section of a board. Scope: pins:read and boards:read.

Build the Pinterest consent URL to open in a browser. The user approves, Pinterest redirects to your redirect_uri with a `code` query parameter, and you exchange that code with pinterest_exchange_oauth_code. Makes no network call.

Exchange the `code` from the OAuth redirect for an access token and refresh token. Access tokens last about 30 days; refresh tokens about a year. Store both securely.

Trade a refresh token for a fresh access token. Use this when calls start failing with 401.

List the authenticated user's pins, newest first. Scope: pins:read (plus pins:read_secret for pins on secret boards).

Fetch a single pin by id, including its media, link and board. Scope: pins:read.

Create a pin on one of the authenticated user's boards. Requires a board_id and a media_source. Scope: pins:write (pins:write_secret for secret boards).

Update a pin's text fields, link or board placement. Media cannot be changed after creation. Scope: pins:write.

Permanently delete a pin. This cannot be undone. Scope: pins:write.

Save an existing pin to one of the authenticated user's boards — the API equivalent of a repin. Scope: pins:write.

Step 1 of video pin creation: register an upload and receive one-time S3 form fields. POST the video to `upload_url` with those `upload_parameters` as multipart form fields, poll pinterest_get_media until status is 'succeeded', then pass the media_id to pinterest_create_pin with source_type 'video_i…

Check a registered upload. Status moves registered -> processing -> succeeded (or failed). Scope: pins:read.

List the account's registered media uploads and their statuses. Scope: pins:read.

Escape hatch: issue an arbitrary request against the Pinterest API v5 using the configured token. Use this only for endpoints no dedicated tool covers — ad accounts, catalogs, audiences, conversion events. Prefer the specific tools when one exists: they validate input and explain failures. Path is r…

Full-text search across the authenticated user's own pins. This does NOT search Pinterest globally — the v5 API exposes no public discovery search. Scope: pins:read.

Full-text search across the authenticated user's own boards. Scope: boards:read.