Pidgr MCP Server
pidgr/pidgr-mcp
MCP server para automação de campanhas de comunicação interna Pidgr
Ver no GitHubServidor MCP que integra a plataforma Pidgr (comunicação interna estruturada) com agentes de IA via Claude, Cursor e ferramentas compatíveis. Expõe 95 ferramentas para gerenciar campanhas, templates, audiências, usuários, análises e integrações de forma programática através de linguagem natural.
Instalação
npx convez-ai pidgr/pidgr-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar criação e disparo de campanhas de comunicação para toda organização
- Gerenciar templates de mensagens e audiências através de agentes IA
- Consultar métricas de entrega e engajamento de campanhas em tempo real
- Integrar reachability de canais (email, Slack, SMS) com segurança de encriptação
- Administrar usuários, roles, permissões e chaves de API programaticamente
Veredito

MCP server robusto e completo para plataforma Pidgr, com suporte a gRPC, OAuth e múltiplos transports. Requer conhecimento de MCP e configuração de API keys, mas oferece cobertura ampla de recursos de comunicação organizacional. Bem documentado e pronto para produção.
README
A tradução para o português deste README ainda está na fila.
pidgr-mcp
Open-source MCP server for Pidgr.
Pidgr is an internal communication platform that replaces passive email and chat announcements with structured, trackable campaigns. Messages reach every employee, actions are verified, and delivery is measurable — not buried in a feed.
pidgr-mcp lets AI agents manage Pidgr through natural language. It exposes 95 tools and works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.
Capabilities
Campaigns — Create, update, start, cancel, and list campaigns. Track per-user delivery status (sent, delivered, acknowledged, missed). Inspect the per-archetype tendency-shift breakdown after a campaign completes (including email-engagement fields: email_delivered_count, email_open_rate_real, email_open_rate_raw).
Templates — Create versioned message templates with variable substitution. Supports Markdown, Rich, and HTML content types.
Audience — Manage recipient groups and organizational teams. Add/remove members, query memberships in batch.
Users — Invite users, manage profiles (department, title, location), assign roles, deactivate accounts.
Organizations — Configure organization settings, default workflows, industry, and SSO attribute mappings.
Roles & Permissions — Create custom roles with granular permission sets. Assign roles to users.
API Keys — Create scoped API keys with optional expiration. List and revoke keys.
Analytics — Query aggregated touch heatmap data with screen, campaign, and time range filters. List session recordings and fetch snapshot data for playback.
Integrations — Manage per-channel recipient reachability (list_reachabilities_for_user, upsert_reachability, remove_reachability) and the per-(org, channel) cost-cap policy (get_cost_cap_policy, set_cost_cap_policy). Reachability identifiers (email addresses, phone numbers, Slack user ids, etc.) are sensitive — they are column-level KMS-encrypted server-side, never logged, and never returned over the wire. Calls route to the IntegrationsService endpoint (see PIDGR_INTEGRATIONS_URL below).
Install
Binary (stdio)
Download from GitHub Releases and verify the checksum:
sha256sum -c checksums.txt
Add to your MCP config:
{
"mcpServers": {
"pidgr": {
"command": "pidgr-mcp",
"env": { "PIDGR_API_KEY": "pidgr_k_..." }
}
}
}
Hosted (Streamable HTTP)
{
"mcpServers": {
"pidgr": {
"url": "https://mcp.pidgr.com"
}
}
}
No API key needed — OAuth handles authentication.
Docker
docker run -e PIDGR_MCP_TRANSPORT=http -e PIDGR_AUTH_ISSUER=<your-issuer-url> -p 8080:8080 ghcr.io/pidgr/pidgr-mcp:latest
Configuration
| Variable | Required | Description |
|---|---|---|
PIDGR_API_KEY | stdio only | Scoped API key |
PIDGR_API_URL | No | API endpoint (gRPC base URL) |
PIDGR_INTEGRATIONS_URL | No | IntegrationsService endpoint (gRPC base URL). Falls back to PIDGR_API_URL when unset — useful when the IntegrationsService is co-hosted at the same gRPC ingress as the main API. |
PIDGR_MCP_TRANSPORT | No | stdio or http |
PIDGR_MCP_ADDR | No | Listen address (http mode) |
PIDGR_AUTH_ISSUER | http only | OIDC issuer URL |
PIDGR_AUTH_CLIENT_ID | No | App client ID for audience validation |
License
Apache 2.0