Repository avatar
Other Tools
v0.1.0
active

url2pin

com.url2pin/url2pin

Turn product and blog links into Pinterest pins, pick the right boards and schedule them.

Documentation

URL2Pin MCP server

Turn any product or blog link into Pinterest pins, then schedule them to your boards, from Claude Desktop, Claude Code, Cursor, VS Code or any app that can run a local Model Context Protocol (MCP) server.

Where it works: this server runs on your own computer, so it needs an app that can start local MCP servers (the ones listed below). It does not work in ChatGPT or in Claude on the web or phone yet: those only connect to servers hosted online, and a hosted URL2Pin server is not available yet.

"Make 4 pins for https://www.amazon.com/dp/B0... and schedule them to my Kitchen board, one a day from tomorrow at 6pm."

URL2Pin reads the page, writes the titles and descriptions, and makes the pin images with AI. The pins keep your exact link, so your Amazon affiliate tag stays on. They are posted through Pinterest's official API.

What you need

  1. A URL2Pin account (free to start).
  2. An API key: My account > API keys at url2pin.com/my-account.
  3. A Pinterest account connected at url2pin.com/scheduled-pins (only needed for scheduling).
  4. Node.js 18 or newer.

Set it up

Claude Desktop

Settings > Developer > Edit Config, then add:

{
  "mcpServers": {
    "url2pin": {
      "command": "npx",
      "args": ["-y", "url2pin-mcp"],
      "env": { "URL2PIN_API_KEY": "u2p_live_..." }
    }
  }
}

Restart Claude Desktop.

Claude Code

claude mcp add url2pin -e URL2PIN_API_KEY=u2p_live_... -- npx -y url2pin-mcp

Cursor

Add the same mcpServers block as Claude Desktop to ~/.cursor/mcp.json.

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "url2pin": {
      "command": "npx",
      "args": ["-y", "url2pin-mcp"],
      "env": { "URL2PIN_API_KEY": "u2p_live_..." }
    }
  }
}

Tools

ToolWhat it does
generate_pinsMakes 1 to 5 pins (default 4) from one link. About 2 minutes. Saved as drafts, nothing is posted.
check_pinsGets the finished pins if generate_pins was still working when it returned.
list_draftsYour newest draft pins, marked if already scheduled or posted.
list_boardsYour connected Pinterest accounts and boards.
suggest_boardsPicks the best board for each pin, with the same matching URL2Pin's scheduler and Autopilot use. Schedules nothing.
create_boardCreates a Pinterest board, with a name suggested from your pins if you don't give one. Never makes a duplicate.
schedule_pinsSchedules drafts, spaced out (default one a day). Up to 20 per call. Give a board, or leave it out and each pin goes to the board that fits it best, with one new board made for pins that fit none.
list_scheduledPins waiting to go out, and any that failed.
cancel_scheduledCancels scheduled pins before they go out.
pins_leftYour plan and pins left this month.

Safety

  • Nothing is posted instantly. Pins are only scheduled, and can be cancelled with cancel_scheduled or in the app until they go out.
  • Only your own drafts can be scheduled. The image must be one your account made in URL2Pin, and the pin keeps that draft's link. A key cannot post other images or change where a pin leads.
  • Boards are only picked when the match is sure. For pins that fit none of your boards, one new board is made per request, named after what they are about (turn it off with new_board_if_none: false). It never duplicates a board name, and at most 3 boards a day per account are made this way. Pins that still fit nothing stay drafts and you are asked.
  • Same rules as the app. Plan limits, free posts, the 800 character limit and the duplicate check all apply.
  • Your key only spends your own pin allowance. Revoke it any time in My account.

Settings

VariableDefault
URL2PIN_API_KEY(required)From My account > API keys.
URL2PIN_WAIT_SECONDS50How long generate_pins waits before handing back a job id. Lower it if your app times out tool calls.
URL2PIN_API_URLURL2Pin's APIOnly for testing.

Pricing

Pins come out of your URL2Pin plan, the same as making them in the app. See url2pin.com/pricing.

Support

url2pin.com/contact

License

MIT

NPM
url2pin-mcp
Install Command
npm install url2pin-mcp