pigeon-mcp 0.0.1

package/README.md

@@ -0,0 +1,133 @@
+# pigeon-mcp
+
+MCP server for Pigeon — the PDF generation API for AI agents. Gives Claude, Cursor, and other AI coding tools the ability to generate PDFs, render templates, and check usage.
+
+## Install
+
+```bash
+npx -y pigeon-mcp
+```
+
+## Configuration
+
+Add to your MCP client config:
+
+### Claude Code
+
+```json
+// ~/.claude/claude_code_config.json or project .mcp.json
+{
+  "mcpServers": {
+    "pigeon": {
+      "command": "npx",
+      "args": ["-y", "pigeon-mcp"],
+      "env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
+    }
+  }
+}
+```
+
+### Cursor
+
+```json
+// .cursor/mcp.json
+{
+  "mcpServers": {
+    "pigeon": {
+      "command": "npx",
+      "args": ["-y", "pigeon-mcp"],
+      "env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+```json
+// ~/Library/Application Support/Claude/claude_desktop_config.json
+{
+  "mcpServers": {
+    "pigeon": {
+      "command": "npx",
+      "args": ["-y", "pigeon-mcp"],
+      "env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
+    }
+  }
+}
+```
+
+### Windsurf
+
+```json
+// .windsurf/mcp.json
+{
+  "mcpServers": {
+    "pigeon": {
+      "command": "npx",
+      "args": ["-y", "pigeon-mcp"],
+      "env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Phase 1 (Active)
+
+| Tool | Description |
+|------|-------------|
+| `render_html` | Render HTML to PDF. Returns a download URL. |
+| `render_template` | Render a named template with data. |
+| `get_render_status` | Check async render job status. |
+| `list_templates` | List available templates and their schemas. |
+| `get_usage` | Get current billing period usage. |
+
+### Phase 2 (Coming Soon)
+
+| Tool | Description |
+|------|-------------|
+| `send_document` | Send via tracked link with analytics. |
+| `get_link` | Get tracked link details. |
+| `get_link_analytics` | Per-viewer, per-page analytics. |
+| `revoke_link` | Revoke tracked link access. |
+
+### Phase 3 (Coming Soon)
+
+| Tool | Description |
+|------|-------------|
+| `create_envelope` | Create a signing envelope. |
+| `get_envelope_status` | Check signing status. |
+| `void_envelope` | Cancel pending signing. |
+| `download_signed` | Download signed PDF + audit trail. |
+
+## Streamable HTTP Transport
+
+For remote/hosted MCP connections:
+
+```bash
+PIGEON_API_KEY=pgn_live_xxxx npx pigeon-mcp-http
+# or
+MCP_PORT=3100 pigeon-mcp-http
+```
+
+Endpoint: `http://localhost:3100/mcp`
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `PIGEON_API_KEY` | Yes | Your Pigeon API key (`pgn_live_...`) |
+| `PIGEON_BASE_URL` | No | Override API URL (default: `https://api.usepigeon.dev`) |
+| `MCP_PORT` | No | HTTP transport port (default: `3100`) |
+
+## Links
+
+- [Pigeon Documentation](https://usepigeon.dev/docs)
+- [Get an API key](https://usepigeon.dev/dashboard)
+- [Roadmap](https://usepigeon.dev/roadmap)
+
+## License
+
+MIT

package/build/http.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/http.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { server } from "./server.js";
+const PORT = parseInt(process.env.MCP_PORT || "3100", 10);
+const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: () => randomUUID(),
+});
+const httpServer = createServer(async (req, res) => {
+    // Health check
+    if (req.url === "/health" && req.method === "GET") {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ status: "ok", server: "pigeon-mcp" }));
+        return;
+    }
+    // MCP endpoint
+    if (req.url === "/mcp" || req.url === "/") {
+        await transport.handleRequest(req, res);
+        return;
+    }
+    res.writeHead(404, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ error: "Not found. Use /mcp for MCP endpoint." }));
+});
+await server.connect(transport);
+httpServer.listen(PORT, () => {
+    console.error(`[pigeon-mcp] Streamable HTTP server listening on port ${PORT}`);
+    console.error(`[pigeon-mcp] MCP endpoint: http://localhost:${PORT}/mcp`);
+    console.error(`[pigeon-mcp] Health check: http://localhost:${PORT}/health`);
+});
+//# sourceMappingURL=http.js.map

package/build/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAE1D,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;IAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACjD,eAAe;IACf,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAClD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IAED,eAAe;IACf,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QAC1C,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,KAAK,CAAC,+CAA+C,IAAI,MAAM,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,+CAA+C,IAAI,SAAS,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { server } from "./server.js";
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[pigeon-mcp] Server started on stdio");
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC"}

package/build/server.d.ts

@@ -0,0 +1 @@
+export declare const server: any;

package/build/server.js

@@ -0,0 +1,301 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Pigeon, PigeonError } from "pigeon-pdf";
+import { z } from "zod";
+import { stubResult } from "./stubs.js";
+export const server = new McpServer({
+    name: "pigeon",
+    version: "0.0.1",
+});
+function getClient() {
+    const apiKey = process.env.PIGEON_API_KEY;
+    if (!apiKey) {
+        throw new Error("PIGEON_API_KEY not set. Get one at https://usepigeon.dev/dashboard");
+    }
+    return new Pigeon({
+        apiKey,
+        baseUrl: process.env.PIGEON_BASE_URL,
+    });
+}
+function errorText(err) {
+    if (err instanceof PigeonError) {
+        return JSON.stringify({
+            error: err.code,
+            message: err.message,
+            docs_url: err.docsUrl,
+        });
+    }
+    if (err instanceof Error) {
+        return JSON.stringify({ error: "INTERNAL_ERROR", message: err.message });
+    }
+    return JSON.stringify({ error: "INTERNAL_ERROR", message: String(err) });
+}
+// ─── Template catalog (hardcoded for Phase 1) ──────────────
+const TEMPLATE_CATALOG = [
+    {
+        name: "invoice",
+        status: "available",
+        description: "Professional invoice with line items, tax, and totals",
+        requiredFields: ["companyName", "customerName", "items", "currency"],
+        optionalFields: ["logo", "notes", "dueDate", "invoiceNumber"],
+    },
+    {
+        name: "receipt",
+        status: "available",
+        description: "Payment receipt with itemized charges",
+        requiredFields: ["merchantName", "items", "total", "paymentMethod"],
+        optionalFields: ["receiptNumber", "date", "address"],
+    },
+    {
+        name: "contract",
+        status: "available",
+        description: "Service agreement or contract document",
+        requiredFields: ["partyA", "partyB", "terms", "effectiveDate"],
+        optionalFields: ["witnessName", "jurisdiction", "terminationClause"],
+    },
+    {
+        name: "report",
+        status: "coming_soon",
+        description: "Data report with charts and tables",
+        requiredFields: ["title", "sections"],
+        optionalFields: ["author", "date", "summary"],
+    },
+    {
+        name: "certificate",
+        status: "available",
+        description: "Award or completion certificate",
+        requiredFields: ["recipientName", "title", "issuerName"],
+        optionalFields: ["date", "description", "certificateId"],
+    },
+    {
+        name: "offer-letter",
+        status: "available",
+        description: "Employment offer letter",
+        requiredFields: ["candidateName", "position", "salary", "startDate", "companyName"],
+        optionalFields: ["benefits", "manager", "expiryDate"],
+    },
+];
+// ═══════════════════════════════════════════════════════════
+// PHASE 1 — ACTIVE TOOLS (5)
+// ═══════════════════════════════════════════════════════════
+server.tool("render_html", "Render an HTML string to a PDF file. Returns a URL to the generated PDF.", {
+    html: z.string().describe("HTML content to render as PDF"),
+    locale: z
+        .enum(["en", "zh-CN", "zh-TW", "ja", "ko"])
+        .optional()
+        .describe("Language locale for CJK font selection"),
+    format: z
+        .enum(["A4", "Letter", "Legal", "A3"])
+        .optional()
+        .describe("Page format (default: A4)"),
+    orientation: z
+        .enum(["portrait", "landscape"])
+        .optional()
+        .describe("Page orientation (default: portrait)"),
+    margin: z
+        .string()
+        .optional()
+        .describe("Page margins as CSS value, e.g. '1cm' or '10mm 20mm'"),
+    waitFor: z
+        .enum(["load", "networkidle"])
+        .optional()
+        .describe("Wait condition before rendering"),
+}, async ({ html, locale, format, orientation, margin, waitFor }) => {
+    try {
+        const pigeon = getClient();
+        const result = await pigeon.render({
+            html,
+            locale,
+            format,
+            orientation,
+            margin,
+            waitFor,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        url: result.url,
+                        pages: result.pages,
+                        size: result.size,
+                        renderTime: result.renderTime,
+                        id: result.id,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: errorText(err) }],
+            isError: true,
+        };
+    }
+});
+server.tool("render_template", "Render a pigeon-template component with data. Returns a PDF URL.", {
+    template: z
+        .enum([
+        "invoice",
+        "receipt",
+        "contract",
+        "report",
+        "certificate",
+        "offer-letter",
+    ])
+        .describe("Template name to render"),
+    data: z
+        .record(z.unknown())
+        .describe("Template data as key-value pairs"),
+    locale: z
+        .enum(["en", "zh-CN", "zh-TW", "ja", "ko"])
+        .optional()
+        .describe("Language locale for CJK font selection"),
+}, async ({ template, data, locale }) => {
+    try {
+        const pigeon = getClient();
+        // Construct HTML from template name + data until template engine is wired
+        const dataRows = Object.entries(data)
+            .map(([k, v]) => `<tr><td style="padding:8px;border:1px solid #ddd;font-weight:bold">${k}</td><td style="padding:8px;border:1px solid #ddd">${String(v)}</td></tr>`)
+            .join("\n");
+        const html = `<!DOCTYPE html>
+<html lang="${locale || "en"}">
+<head><meta charset="UTF-8"><style>
+  body { font-family: sans-serif; padding: 40px; color: #333; }
+  h1 { text-transform: capitalize; border-bottom: 2px solid #333; padding-bottom: 8px; }
+  table { width: 100%; border-collapse: collapse; margin-top: 20px; }
+</style></head>
+<body>
+  <h1>${template}</h1>
+  <table>${dataRows}</table>
+</body>
+</html>`;
+        const result = await pigeon.render({ html, locale });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        url: result.url,
+                        pages: result.pages,
+                        size: result.size,
+                        template,
+                        id: result.id,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: errorText(err) }],
+            isError: true,
+        };
+    }
+});
+server.tool("get_render_status", "Check the status of an async render job.", {
+    job_id: z.string().describe("The render job ID returned from render_html"),
+}, async ({ job_id }) => {
+    try {
+        const pigeon = getClient();
+        const result = await pigeon.getRender(job_id);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: result.id,
+                        status: result.status,
+                        url: result.url,
+                        pages: result.pages,
+                        size: result.size,
+                        renderTime: result.renderTime,
+                        errorCode: result.errorCode,
+                        errorMessage: result.errorMessage,
+                        createdAt: result.createdAt,
+                        completedAt: result.completedAt,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: errorText(err) }],
+            isError: true,
+        };
+    }
+});
+server.tool("list_templates", "List available pigeon-templates with their required data schemas.", {}, async () => {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(TEMPLATE_CATALOG, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_usage", "Get current API usage and remaining quota for this billing period.", {}, async () => {
+    try {
+        const pigeon = getClient();
+        const usage = await pigeon.getUsage();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        renders: usage.renders,
+                        period: usage.period,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: errorText(err) }],
+            isError: true,
+        };
+    }
+});
+// ═══════════════════════════════════════════════════════════
+// PHASE 2 STUBS — Send & Track (4)
+// ═══════════════════════════════════════════════════════════
+server.tool("send_document", "Send a document via tracked link with per-page analytics.", {
+    document_url: z.string().describe("URL of the PDF to send"),
+    recipient_email: z.string().describe("Recipient email address"),
+    subject: z.string().optional().describe("Email subject line"),
+}, async () => stubResult(2));
+server.tool("get_link", "Get tracked link details and status.", {
+    link_id: z.string().describe("The tracked link ID"),
+}, async () => stubResult(2));
+server.tool("get_link_analytics", "Get per-viewer, per-page analytics for a tracked link.", {
+    link_id: z.string().describe("The tracked link ID"),
+}, async () => stubResult(2));
+server.tool("revoke_link", "Revoke access to a tracked link.", {
+    link_id: z.string().describe("The tracked link ID to revoke"),
+}, async () => stubResult(2));
+// ═══════════════════════════════════════════════════════════
+// PHASE 3 STUBS — Sign (4)
+// ═══════════════════════════════════════════════════════════
+server.tool("create_envelope", "Create a signing envelope with one or more signers.", {
+    document_url: z.string().describe("URL of the PDF to sign"),
+    signers: z
+        .array(z.object({
+        name: z.string(),
+        email: z.string(),
+    }))
+        .describe("List of signers"),
+    subject: z.string().optional().describe("Signing request subject"),
+}, async () => stubResult(3));
+server.tool("get_envelope_status", "Check signing status and audit trail.", {
+    envelope_id: z.string().describe("The envelope ID"),
+}, async () => stubResult(3));
+server.tool("void_envelope", "Cancel a pending signing envelope.", {
+    envelope_id: z.string().describe("The envelope ID to void"),
+    reason: z.string().optional().describe("Reason for voiding"),
+}, async () => stubResult(3));
+server.tool("download_signed", "Download the completed signed PDF with audit trail.", {
+    envelope_id: z.string().describe("The envelope ID"),
+}, async () => stubResult(3));
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/build/stubs.d.ts

@@ -0,0 +1,7 @@
+export declare function stubResult(phase: number): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};

package/build/stubs.js

@@ -0,0 +1,16 @@
+export function stubResult(phase) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    error: "not_yet_available",
+                    message: `This tool is coming in Phase ${phase}. See https://usepigeon.dev/roadmap`,
+                    phase,
+                }),
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=stubs.js.map

package/build/stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../src/stubs.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,gCAAgC,KAAK,qCAAqC;oBACnF,KAAK;iBACN,CAAC;aACH;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "pigeon-mcp",
+  "version": "0.0.1",
+  "type": "module",
+  "bin": {
+    "pigeon-mcp": "./build/index.js",
+    "pigeon-mcp-http": "./build/http.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js build/http.js"
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "pigeon-pdf": "workspace:*",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}