convez.ai
MCP ServerIntegração & APIsAvançado
pidgr

Pidgr MCP Server

pidgr/pidgr-mcp

MCP server para automação de campanhas de comunicação interna Pidgr

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 semanas
Versão
v0.15.0
Issues abertas
2
Contribuidores
1

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

VariableRequiredDescription
PIDGR_API_KEYstdio onlyScoped API key
PIDGR_API_URLNoAPI endpoint (gRPC base URL)
PIDGR_INTEGRATIONS_URLNoIntegrationsService 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_TRANSPORTNostdio or http
PIDGR_MCP_ADDRNoListen address (http mode)
PIDGR_AUTH_ISSUERhttp onlyOIDC issuer URL
PIDGR_AUTH_CLIENT_IDNoApp client ID for audience validation

License

Apache 2.0

Ver o original no GitHub

Bom para

Relacionados