SavePinner Pinterest URL Tools

io.github.jianknPublished by GitHub account jianknv0.1.1Updated Oct 24, 2026

Parse, validate, classify, and normalize Pinterest URLs locally without network requests.

VerifiedSTDIODesktop onlyWeb Search & ScrapingDeveloper Tools

Overview

AI-generated overview

Parses, validates, classifies and normalizes Pinterest URLs locally, returning canonical links and type-specific IDs without network requests.

What you can do
  • Parse a Pinterest URL into its kind, canonical URL, host and type-specific identifiers
  • Normalize supported URLs to canonical form and strip tracking parameters
  • Check whether a value is a supported Pinterest URL
  • Cover Pin, pin.it, profile, board and Ideas URLs across Pinterest country domains
When to use it
Useful when an assistant handles Pinterest links and needs to confirm they are genuine Pinterest URLs, deduplicate them, or clean tracking parameters before storing or sharing them. It is a small, single-purpose helper rather than a media downloader.
Requirements
Runs as a local stdio process via npx with Node.js 18 or newer, or as a Docker container. No accounts, API keys, environment variables or headers are needed. A public Streamable HTTP endpoint is also offered for remote clients.
Before you install
The tools only inspect URL strings; they do not fetch pages or download media, so results say nothing about whether a Pin still exists. The project is independent and not affiliated with Pinterest. The remote endpoint is described as read-only and unauthenticated, but URL text you send to it leaves your machine.

Installation

In SourceWeft

  1. Open SavePinner Pinterest URL Tools in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolPurpose
parse_pinterest_urlReturn the URL kind, canonical URL, host, and type-specific identifiers.
normalize_pinterest_urlConvert a supported URL to canonical form and remove tracking parameters.
is_pinterest_urlCheck 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.

bash
npx -y savepinner-mcp

Client configuration

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

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

Remote MCP

Connect any Streamable HTTP client to the public endpoint:

text
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:

bash
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:

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

returns:

json
{  "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

bash
npm installnpm testnpm 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.

Source: README.md at commit aac1eb6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts