Skip to main content
Glama
SavePinner MCP

SavePinner MCP

SavePinner MCP

An MCP server for parsing, validating, classifying, and normalizing Pinterest URLs. It supports local stdio and public Streamable HTTP. The tools make no outbound network requests and do 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.

Related MCP server: @striderlabs/mcp-pinterest

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"]
    }
  }
}

Remote MCP

Connect any Streamable HTTP client to the public endpoint:

https://savepinner-pinterest-url-mcp.chenxuanshimo.workers.dev/mcp

The endpoint is read-only and does not require authentication.

The public Pinterest URL validation guide explains the validation and normalization boundaries used by the tools.

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

  • URL processing is local to the running server.

  • The tools do not make outbound 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 the Pinterest image downloader, 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
npm run worker:check

License

MIT

Connection diagnostics

Use the connection diagnostic guide to check transport, tool discovery, normalization and deceptive-host rejection before investigating media availability.

Available Tools

3 tools
is_pinterest_urlValidate Pinterest URLA
Read-onlyIdempotent

Return whether a value is a supported Pinterest URL without making a network request.

Inputs: url (required). Returns: isPinterestUrl

normalize_pinterest_urlNormalize Pinterest URLA
Read-onlyIdempotent

Convert a supported Pinterest URL to its canonical form and remove tracking parameters.

Inputs: url (required). Returns: normalizedUrl

parse_pinterest_urlParse Pinterest URLA
Read-onlyIdempotent

Parse a Pinterest URL and return its kind, canonical URL, host, and type-specific identifiers.

Inputs: url (required). Returns: host, kind, pinId, ideaId, +6 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool serves a distinct purpose: one parses URLs, one normalizes them, and one validates them as Pinterest URLs. There is no overlap or ambiguity in their roles.

    Naming Consistency5/5

    All tool names follow a consistent verb_object pattern: parse_pinterest_url, normalize_pinterest_url, is_pinterest_url. The pattern is predictable and uniform.

    Tool Count5/5

    Three tools is exactly right for a focused URL utility server. Each tool addresses a specific need without clutter or redundancy.

    Completeness5/5

    The tool set covers the core operations for Pinterest URL handling: validation, parsing, and normalization. There are no obvious gaps for this narrow domain.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers