SavePinner MCP

An MCP server for parsing, validating, classifying, and normalizing Pinterest URLs. It runs locally, makes no network requests, and does not download media.

Tools

Tool	Purpose
parse_pinterest_url	Return the URL kind, canonical URL, host, and type-specific identifiers.
normalize_pinterest_url	Convert a supported URL to canonical form and remove tracking parameters.
is_pinterest_url	Check whether a value is a supported Pinterest URL.

Supported URL kinds include Pin, pin.it, profile, board, and Ideas URLs across Pinterest country domains.

Run

Node.js 18 or newer is required.

npx -y savepinner-mcp

Client configuration

Add the server to an MCP client that supports local stdio servers:

{
  "mcpServers": {
    "savepinner": {
      "command": "npx",
      "args": ["-y", "savepinner-mcp"]
    }
  }
}

Docker

Build and run the server as a local stdio container:

docker build -t savepinner-mcp .
docker run --rm -i savepinner-mcp

The runtime image executes as the unprivileged node user and does not require secrets, volumes, or network access.

Example

Calling parse_pinterest_url with:

https://de.pinterest.com/pin/987654321/?utm_source=share

returns:

{
  "kind": "pin",
  "originalUrl": "https://de.pinterest.com/pin/987654321/?utm_source=share",
  "normalizedUrl": "https://www.pinterest.com/pin/987654321/",
  "host": "de.pinterest.com",
  "pinId": "987654321"
}

Privacy and safety

• All processing is local.
• The server does not make network requests.
• The server does not download media.
• Hostnames are checked against an exact Pinterest domain allow list.
• Lookalike domains and non-HTTPS URLs are rejected.

The URL parser is provided by pinterest-url-normalizer.

This project is maintained by the team behind SavePinner, a browser tool for inspecting media exposed by public Pinterest Pin URLs.

Pinterest is a trademark of Pinterest, Inc. This project is independent and is not affiliated with or endorsed by Pinterest.

Development

npm install
npm test

License

MIT