PIN MCP — App Purpose

Self-hosted personal automation tool operated by Julien Marani.

Purpose

PIN MCP is a personal automation tool used by Julien Marani to assemble inspiration mood boards for in-house marketing workflows (restaurant food photography, dance studio communications, golf club content). It reads public Pinterest content on behalf of a single authenticated user.

What it does

• Searches public Pinterest pins and boards by free-text query.
• Lists the operator’s own boards and their pins.
• Fetches full pin metadata (title, description, image URLs).
• Bundles selected pins into a temporary zip download (1-hour signed link).

What it does not do

• Does not publish, post, or modify Pinterest content.
• Does not create or manage other users’ accounts.
• Does not aggregate or resell Pinterest data.
• Does not run advertising or analytics.

Architecture

The App is a Model Context Protocol (MCP) server that exposes nine tools consumable by Anthropic’s Claude assistant. The operator is the sole authorized caller via a Bearer token. All Pinterest tokens are encrypted at rest with AES-256-GCM. The source code is kept in a private repository on GitHub.

Required scopes

• boards:read — list the operator’s boards.
• pins:read — search pins and fetch pin metadata.
• user_accounts:read — resolve the authenticated username.

Hosting

The App is self-hosted on a private Hostinger VPS controlled by the operator. The legal documents (this page and the privacy policy) are hosted as static pages on GitHub Pages so they are accessible even when the App is offline.

Contact

julienmarani98@gmail.com