@gopigeon/mcp

MCP server for Gopigeon — a form submission relay service positioned for AI coding agents.

Exposes three tools over stdio:

• create_endpoint — no auth; creates a new anonymous Gopigeon endpoint
• get_submissions — requires API key; reads submissions for an endpoint you own
• list_endpoints — requires API key; lists endpoints you own

Install (Claude Code)

# Anonymous mode — create_endpoint only
claude mcp add --transport stdio gopigeon -- npx -y @gopigeon/mcp

# With API key for get_submissions + list_endpoints
claude mcp add --transport stdio --env GOPIGEON_API_KEY=YOUR_KEY gopigeon -- npx -y @gopigeon/mcp

Install (Cursor / generic JSON config)

{
  "mcpServers": {
    "gopigeon": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@gopigeon/mcp"],
      "env": { "GOPIGEON_API_KEY": "${GOPIGEON_API_KEY}" }
    }
  }
}

Environment

• GOPIGEON_BASE_URL — API base URL. Defaults to https://gopigeon.dev. Override for self-hosted instances or local testing (http://localhost:8090).
• GOPIGEON_API_KEY — Optional. Required for get_submissions and list_endpoints. Generate via POST /api/keys from the dashboard.

Get an API Key

# Log in first, then:
curl -X POST https://gopigeon.dev/api/keys \
  -H "Authorization: Bearer <your_session_token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"claude-code"}'
# → { "api_key": "<64 hex chars>", ... }
# Store immediately — it will not be shown again.

Develop

cd mcp
npm install
npm run build     # compiles src/ → dist/
npm test          # vitest suite
npm run dev       # tsx src/index.ts — runs against live server

License

MIT