Build on Pengo, not around it
REST API, CLI, MCP server, signed webhooks, and HMAC AI connectors. Every endpoint documented in OpenAPI.
GET /v1/conversations
POST /v1/webhooks
GET /v1/visitors
Authorization: Bearer YOUR_API_KEY
Copy-paste starting points
REST curls, CLI commands, MCP config, and signature verification snippets. Every endpoint is in OpenAPI.
List open conversations with a scoped API key.
curl -X GET "https://app.pengo.chat/api/v1/conversations" \
-H "Authorization: Bearer YOUR_API_KEY" Install the CLI and query conversations from your terminal.
# Install the Pengo CLI
npm install -g @pengochat/cli
# List open conversations
pengochat conversations list --status open Connect Pengo to MCP-compatible agent clients.
# Add to your MCP client config
{
"mcpServers": {
"pengo": {
"command": "npx",
"args": ["@pengochat/mcp-server"],
"env": { "PENGO_API_KEY": "YOUR_API_KEY" }
}
}
} Verify inbound webhook signatures with HMAC-SHA256.
# Verify webhook signature
import crypto from 'crypto';
const sig = req.headers['x-pengo-signature'];
const expected = crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(rawBody)
.digest('hex'); Validate AI connector callbacks from your backend.
# AI connector HMAC verify
const payload = timestamp + '.' + JSON.stringify(body);
const expected = crypto
.createHmac('sha256', CONNECTOR_SECRET)
.update(payload)
.digest('hex'); Resources you can call today
Conversations, visitors, webhooks, and scoped API keys from dashboard settings.
Docs and SDK entry points
OpenAPI reference, npm packages for CLI and MCP, and webhook signing guides.
Build on Pengo with a free API key
7-day free trial · Card required · Cancel anytime