SavePinner MCP
The SavePinner MCP server provides read-only, idempotent tools for parsing, validating, classifying, and normalizing Pinterest URLs—all without making outbound network requests, downloading media, or accepting non-HTTPS or lookalike domains.
parse_pinterest_url: Extracts the URL's kind (pin, short link, profile, board, or ideas), canonical and normalized forms, host, and type-specific identifiers such aspinId,ideaId,ideaSlug,shortcode,username, andboardSlug.normalize_pinterest_url: Converts any supported Pinterest URL to its canonical form and strips tracking parameters (e.g.,utm_source).is_pinterest_url: Returns a boolean indicating whether a given string is a valid, supported Pinterest URL.
It handles pins, pin.it shortened links, user profiles, boards, and ideas across Pinterest country domains, operating entirely locally via stdio or remote Streamable HTTP endpoints.
Provides tools for parsing, validating, classifying, and normalizing Pinterest URLs, supporting pin, pin.it, profile, board, and Ideas URL kinds across Pinterest country domains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SavePinner MCP What kind of Pinterest URL is https://www.pinterest.com/pin/123456789/?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Return the URL kind, canonical URL, host, and type-specific identifiers. |
| Convert a supported URL to canonical form and remove tracking parameters. |
| 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-mcpClient 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/mcpThe 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-mcpThe 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=sharereturns:
{
"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:checkLicense
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 toolsis_pinterest_urlValidate Pinterest URLARead-onlyIdempotent
Return whether a value is a supported Pinterest URL without making a network request.
Inputs: url (required). Returns: isPinterestUrl
normalize_pinterest_urlNormalize Pinterest URLARead-onlyIdempotent
Convert a supported Pinterest URL to its canonical form and remove tracking parameters.
Inputs: url (required). Returns: normalizedUrl
parse_pinterest_urlParse Pinterest URLARead-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
Scored across 3 tools
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.
All tool names follow a consistent verb_object pattern: parse_pinterest_url, normalize_pinterest_url, is_pinterest_url. The pattern is predictable and uniform.
Three tools is exactly right for a focused URL utility server. Each tool addresses a specific need without clutter or redundancy.
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
Related MCP Connectors
Hosted Pinterest Pages MCP server, with each action switched on or off per account.
Pinterest pins, boards, profiles and keyword search to JSON: saves, images, links, creators.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceThis read-only MCP Server allows you to connect to Pinterest data from Claude Desktop through CData JDBC Drivers. Free (beta) read/write servers available at https://www.cdata.com/solutions/mcp6MIT
- AlicenseBqualityDmaintenanceMCP server connector for Pinterest — search pins, manage boards, save pins, and follow users via Playwright browser automation.1013 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server that lets Claude interact with Pinterest — browsing, creating, and managing boards, pins, sections, and user profiles via the Pinterest API v5.1528 npmMIT
- AlicenseAqualityDmaintenanceExtracts images, gifs, videos, and search results from Pinterest without authentication. Supports search, pin details, board pins, related pins, autocomplete, and media downloads.61MIT