pinui-mcp

MCP server that connects AI coding agents (Claude Code, Codex, Cursor) to PinUI. Pin a UI element in your browser, then let your agent pull the AI-ready change request directly — no copy-paste.

Setup

1. Install the PinUI browser extension, log in, and make sure Sync pins is enabled in settings (it is by default).
2. Create an API key at https://pinui.dev/dashboard/api-keys.
3. Connect your agent:

Claude Code

claude mcp add pinui -e PINUI_API_KEY=pinui_sk_... -- npx -y pinui-mcp

Codex

npx -y pinui-mcp setup codex --api-key pinui_sk_...

Cursor

npx -y pinui-mcp setup cursor --api-key pinui_sk_...

Usage

Pin an element with the extension, then ask your agent:

implement my latest pin

Slash commands are agent-specific:

• Claude Code: /pinui:latest-pin to implement the newest pin, /pinui:list-pins to see a numbered list and pick one to implement, /pinui:clear-pins to wipe synced pins (asks for confirmation first).
• Codex: /pinui-get-latest-pin — but only on builds that surface ~/.codex/prompts/*.md as slash commands. Codex does not expose MCP-registered prompts as slash commands, and some custom Codex distributions ignore the prompts folder entirely. If /pinui-get-latest-pin doesn't appear, just ask the agent (see above) — the MCP tools work regardless.
• Cursor: no slash command; ask the agent in natural language.

Tools

| Tool | Description | | --- | --- | | get_latest_pin | Fetch the most recent pinned change request | | list_pins | List recent pins, newest first (limit optional) | | clear_pins | Delete all synced pins |

Configuration

| Env var / flag | Description | | --- | --- | | PINUI_API_KEY / --api-key | Your PinUI API key (pinui_sk_...), required | | PINUI_API_URL / --api-url | API base URL, defaults to https://api.pinui.dev/api/v1 |