Evo CRM MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Porta HTTP, padrão 3000. Escuta em 0.0.0.0. | 3000 |
| MCP_SCOPE | No | stdio: read (padrão) ou write. HTTP determina o escopo pelo bearer, ignorando esta variável. | read |
| EVOCRM_BASE_URL | Yes | Obrigatória. Origem do CRM, por exemplo https://crm.example.com, sem caminho, query ou credenciais. | |
| EVOCRM_API_TOKEN | Yes | Obrigatória. Token do CRM enviado exclusivamente ao CRM no header api_access_token. | |
| MCP_ALLOWED_ORIGINS | No | Origens exatas separadas por vírgulas, por exemplo https://assistant.example.com. Vazio rejeita requisições com Origin; clientes sem esse header continuam sujeitos ao bearer. | |
| MCP_TOKEN_SHA256_READ | No | HTTP: hash SHA-256 hexadecimal de um token próprio para leitura. | |
| MCP_TOKEN_SHA256_WRITE | No | HTTP: hash SHA-256 hexadecimal de outro token próprio para escrita. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| contacts_listC | Lista contatos do CRM com paginação. |
| contacts_searchB | Busca contatos por nome, e-mail, telefone ou identificador. |
| contact_getB | Consulta um contato. Use include_notes=true para conferir notas após resultado incerto. |
| conversations_listB | Lista conversas com filtros e paginação. |
| conversation_getC | Consulta os detalhes de uma conversa. |
| messages_listA | Lista mensagens em ordem cronológica. O upstream usa cursor, não número de página: avance com next_before ou next_after. Sem cursor, retorna as mais recentes. |
| pipelines_listA | Lista pipelines acessíveis e suas etapas. A lista não inclui os itens no upstream atual. |
| pipeline_getA | Consulta um pipeline com suas etapas e itens; o upstream devolve o quadro completo. |
| pipeline_items_listA | Lista itens de um pipeline. Paginação aplicada localmente, pois o upstream devolve a coleção completa. |
| tasks_listB | Lista tarefas de um item de pipeline com paginação local. Inclui subtarefas na hierarquia. |
| inboxes_listB | Lista caixas de entrada acessíveis com paginação. |
| agents_listA | Lista agentes de IA via /agents (proxy evo-core). Não lista usuários humanos; seus IDs não servem para atribuir atendentes. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools are clearly separated by resource and action: list, search, and get operations target contacts, inboxes, agents, conversations, messages, pipelines, pipeline items, and tasks. The main overlap is between pipeline_get, which can return pipeline items, and pipeline_items_list, though the descriptions clarify the distinction.
Tools consistently use snake_case resource_action naming such as contacts_list, conversations_list, pipeline_get, and tasks_list. There are minor singular/plural deviations (contacts_list/search vs contact_get, pipelines_list vs pipeline_get), but the overall convention is predictable.
Twelve tools is well within the appropriate range for a CRM server and each tool maps to a recognizable read operation. The set is not bloated, though it is notably read-only.
The surface covers many list/get/search operations but lacks any create, update, or delete tools for contacts, conversations, pipeline items, or tasks. For a CRM, this is a significant gap because agents cannot perform common write workflows.