{
  "markdown": "# DesignPin MCP Server\n<!-- mcp-name: io.github.opjhabuilds/designpin-mcp-server -->\n\n> An MCP server that lets any AI assistant push HTML prototypes to **[DesignPin](https://designpin.pro)** for team review and read back reviewer feedback.\n\n## What this does\n\nDesignPin is a tool for reviewing HTML prototypes with DOM-anchored comments. This package wraps the DesignPin REST API as a [Model Context Protocol](https://modelcontextprotocol.io) server, exposing three tools — `createShareLink`, `uploadVersion`, `listComments` — to any MCP-compatible AI client.\n\nOnce configured, your AI assistant — Claude Desktop, Cursor, VS Code (Copilot), Gemini CLI, or any other MCP-compatible client — can ship a generated HTML prototype to a shareable review link, pull back reviewer comments to incorporate, and push iterations as new versions, all from inside the same conversation that produced the design.\n\n> **For ChatGPT users:** ChatGPT does not currently support MCP servers. Use the [direct REST API](https://designpin.pro/openapi.json) via Custom GPT Actions instead — no MCP server needed.\n\n## Install + run\n\nThe server is invoked by your MCP client; you don't run it directly during normal use. The simplest path is `npx` invocation, which fetches and runs without a global install:\n\n```bash\nnpx -y @designpin/mcp-server --api-key dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx --project-id proj_example_abc123\n```\n\nFor most workflows you'll set this in your MCP client's config file rather than running it manually — see [Client config examples](#client-config-examples) below.\n\nTo verify the install works:\n\n```bash\nnpx -y @designpin/mcp-server --version\n# → 0.1.0\n\nnpx -y @designpin/mcp-server --help\n# → usage info\n```\n\n## Get an API key\n\n1. Open [designpin.pro](https://designpin.pro) and sign in.\n2. Open any project (or create one).\n3. Click **API & Integrations** in the project header.\n4. Click **Generate new key**, give it a name (e.g. \"Claude Desktop\").\n5. **Copy the key immediately** — it's shown once and cannot be retrieved later.\n\nEach key is scoped to a single project. Generate separate keys per client / use case so you can revoke them individually.\n\n## Configuration\n\nBoth CLI flags and environment variables are supported. Flags win when both are present.\n\n| CLI flag | Env var | Required | Default | Description |\n|---|---|---|---|---|\n| `--api-key` | `DESIGNPIN_API_KEY` | for `uploadVersion`, `listComments` | — | Your `dp_live_...` API key |\n| `--project-id` | `DESIGNPIN_PROJECT_ID` | for `uploadVersion` | — | Project ID the key is scoped to |\n| `--base-url` | `DESIGNPIN_BASE_URL` | no | `https://designpin.pro` | API base URL (override for testing) |\n| `--help` | — | no | — | Show usage and exit |\n| `--version` | — | no | — | Print version and exit |\n\n> **Security note:** CLI flags are visible in `ps` output on multi-user systems. Prefer environment variables on shared machines.\n\n## Tools\n\n### `createShareLink`\n\nCreate a public review link for an HTML prototype. No project setup required — creates a brand-new throwaway project. Rate-limited to 10 requests/hour per IP.\n\n| Input | Type | Required | Description |\n|---|---|---|---|\n| `html` | string | yes | Complete HTML document to share |\n| `title` | string | yes | Display name for the share, max 80 chars |\n| `authorName` | string | no | Author name shown on review page |\n\n**Returns:** JSON with `url`, `reviewToken`, `projectId`, `moduleId`, `versionId`.\n\n**Example prompt to your AI assistant:**\n> \"Take this HTML and create a DesignPin share link titled 'Landing page hero V3'.\"\n\n### `uploadVersion`\n\nUpload a new HTML version to an existing DesignPin module. Auto-increments `versionNumber`. Requires the API key + `projectId` from configuration plus a `moduleId` from the user.\n\n| Input | Type | Required | Description |\n|---|---|---|---|\n| `html` | string | yes | Complete HTML for the new version |\n| `moduleId` | string | yes | Target module within the configured project |\n| `description` | string | no | Version description shown in the sidebar |\n\n**Returns:** JSON with `url`, `versionId`, `versionNumber`.\n\n**Example prompt:**\n> \"Push this revised HTML as a new version to module `mod_example_def456` with the description 'Address pin #3 contrast feedback'.\"\n\n### `listComments`\n\nFetch comments visible on a specific version of a DesignPin module. Uses chronological cutoff semantics matching the web UI: a comment is visible on version V if its origin version is V or any earlier version.\n\n| Input | Type | Required | Description |\n|---|---|---|---|\n| `moduleId` | string | yes | Module ID |\n| `versionId` | string | yes | Specific version to view comments on |\n\n**Returns:** JSON with a `comments` array and a `summary` string like `\"3 open, 1 resolved\"`.\n\n**Example prompt:**\n> \"Get the comments on module `mod_example_def456` at version `ver_example_ghi789` and tell me what's blocking approval.\"\n\n## Client config examples\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"designpin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@designpin/mcp-server\"],\n      \"env\": {\n        \"DESIGNPIN_API_KEY\": \"dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n        \"DESIGNPIN_PROJECT_ID\": \"proj_example_abc123\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\nEdit `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"designpin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@designpin/mcp-server\"],\n      \"env\": {\n        \"DESIGNPIN_API_KEY\": \"dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n        \"DESIGNPIN_PROJECT_ID\": \"proj_example_abc123\"\n      }\n    }\n  }\n}\n```\n\nReload Cursor after saving.\n</details>\n\n<details>\n<summary><b>VS Code (Copilot with MCP)</b></summary>\n\nAdd to your VS Code user settings JSON or a workspace `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"designpin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@designpin/mcp-server\"],\n      \"env\": {\n        \"DESIGNPIN_API_KEY\": \"dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n        \"DESIGNPIN_PROJECT_ID\": \"proj_example_abc123\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Gemini CLI extension</b></summary>\n\nEdit your Gemini CLI config (path varies by version). Both the env-style and the flag-style work; flag-style is shown here:\n\n```json\n{\n  \"mcpServers\": {\n    \"designpin\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"@designpin/mcp-server\",\n        \"--api-key\", \"dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n        \"--project-id\", \"proj_example_abc123\"\n      ]\n    }\n  }\n}\n```\n</details>\n\n## Example conversation\n\n```\nYou:  Generate a pricing page with three tiers (Free, Pro $12, Team $29).\n      Push it to DesignPin so my team can review.\n\nAI:   [generates HTML, calls createShareLink]\n      Share link created. Send this to your team:\n      https://designpin.pro/review/EXAMPLE_TOKEN_xyz\n\n      Project: proj_example_abc123\n      Module:  mod_example_def456\n      Version: ver_example_ghi789\n\n[team reviews and leaves 4 comments]\n\nYou:  Pull the feedback from module mod_example_def456 at version\n      ver_example_ghi789 and address the must-fix comments.\n\nAI:   [calls listComments]\n      Open comments (4):\n      - P0 Pin #1 \"CTA contrast fails WCAG AA on the Pro tier\"\n      - P1 Pin #2 \"Pricing hidden until hover — make always visible\"\n      - P1 Pin #3 \"Annual toggle is ambiguous — show savings %\"\n      - P2 Pin #4 \"Logo could link back to homepage\"\n\n      I'll regenerate the HTML with the two P0/P1 issues addressed.\n\nYou:  Push the revision.\n\nAI:   [generates updated HTML, calls uploadVersion]\n      v2 uploaded. Same review URL — your team can compare versions.\n```\n\n## Direct REST API\n\nIf you want to call the DesignPin API without an MCP server, the OpenAPI 3.1 spec is published at:\n\n**https://designpin.pro/openapi.json**\n\nImport it into Postman, generate a client SDK, or use it directly with ChatGPT Custom GPT Actions.\n\n## Links\n\n- **DesignPin app:** https://designpin.pro\n- **OpenAPI spec:** https://designpin.pro/openapi.json\n- **GitHub:** https://github.com/opjhabuilds/designpin-mcp-server\n- **Issues:** https://github.com/opjhabuilds/designpin-mcp-server/issues\n\n## License\n\nMIT © 2026 Omprakash Jha\n",
  "bytes": 8381,
  "sha": "ef08e309fdee8774decc76d1afee6f0b615f2f805906614693c1823482e5fbe6",
  "repo_slug": "opjhabuilds/designpin-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_opjhabuilds_designpin_mcp_serv_53576c38/readme"
}