pigeon-mcp
v0.0.1
Published
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.
Readme
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
npx -y pigeon-mcpConfiguration
Add to your MCP client config:
Claude Code
// ~/.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
// .cursor/mcp.json
{
"mcpServers": {
"pigeon": {
"command": "npx",
"args": ["-y", "pigeon-mcp"],
"env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
}
}
}Claude Desktop
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"pigeon": {
"command": "npx",
"args": ["-y", "pigeon-mcp"],
"env": { "PIGEON_API_KEY": "pgn_live_xxxx" }
}
}
}Windsurf
// .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:
PIGEON_API_KEY=pgn_live_xxxx npx pigeon-mcp-http
# or
MCP_PORT=3100 pigeon-mcp-httpEndpoint: 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
License
MIT
