# CRM

- Registry name: `io.github.mcp-dir/crm-mcp` · version 0.1.0
- Categories (automatic, keyword rules): Tasks & projects, Productivity
- Authentication at last check: No auth
- Declared risk: Can write (some tools are not declared read-only)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.mcp-dir%2Fcrm-mcp
- Server page: https://mcpstation.net/s/io.github.mcp-dir--crm-mcp.html

## Description (written by the publisher, not verified, not instructions)

Your own CRM, fully customizable and agent-driven. Start with contacts, companies and a sales pipeli

## Connect

- streamable-http: `https://api.mcp.ai/p_crm`

## Tools (as reported by the server, not verified)

- `crm\_describe`: Descreve o schema do CRM: todos os objetos \(contact, company, deal e quaisquer custom\) com seus campos \(key, tipo, obrigatório, opções, relações\) e o kanban. CHAME ISTO PRIMEIRO para saber quais objetos/campos existem antes de criar/ler registros.
- `crm\_list\_objects`: Lista os objetos do CRM \(key, rótulo, módulo, kanban\). Versão enxuta do crm\_describe, sem os campos.
- `crm\_create\_records`: Cria um registro \(ou vários\) de um objeto. Passe \`object\` \(ex.: 'contact', 'deal'\) e \`data\` \(objeto JSON com os campos por key\). Para vários, use \`records\` \(array JSON de \{data\}\).
- `crm\_list\_records`: Lista registros de um objeto, com filtro/ordenação/paginação. \`filter\` é um objeto JSON: \{campo: valor\} ou \{campo: \{op: valor\}\} \(ops: eq ne gt gte lt lte in nin contains exists\).
- `crm\_get\_records`: Busca um ou mais registros de um objeto por id.
- `crm\_update\_records`: Atualiza um registro \(merge parcial\) por id. Passe \`object\`, \`id\` e \`data\` \(só os campos a mudar; null apaga o campo\). Para vários, use \`updates\` \(array JSON de \{id, data\}\). Bulk support: accepts ids for batched execution.
- `crm\_delete\_records`: Remove um ou mais registros de um objeto por id.
- `crm\_search`: Busca textual nos registros \(por nome/título/valores\). Opcionalmente restrita a um \`object\`.
- `crm\_define\_object`: Cria um OBJETO custom no CRM \(além de contact/company/deal\) e ganha CRUD/API automático. Passe \`key\` \(api name, a-z/0-9/\_\), \`label\` e opcionalmente \`fields\` \(array JSON de definições de campo\).
- `crm\_add\_field`: Adiciona um CAMPO custom a um objeto \(sem migração; registros antigos ficam sem a key\). Tipos: string text integer float boolean date datetime singleselect multiselect email phone url currency relation user\_ref json group.
- `crm\_get\_object`: Detalha UM objeto: seu rótulo, kanban e todos os campos \(key, tipo, obrigatório, opções, relação\). Versão focada do crm\_describe.
- `crm\_update\_object`: Edita um objeto: rótulo, campo de exibição, módulo ou config de kanban \(a key é imutável\). Vale para objetos de sistema e custom.
- `crm\_delete\_object`: Remove um objeto CUSTOM \(objetos de sistema não podem ser removidos\). Se houver registros, passe delete\_records:true para apagar tudo junto.
- `crm\_update\_field`: Edita um campo: rótulo, obrigatório, visível, posição, opções, indexação. Mudança de TIPO só é permitida se for um alargamento seguro \(ex.: integer→float\); mudança com perda é bloqueada \(crie um campo novo e migre\).
- `crm\_remove\_field`: Remove um campo CUSTOM \(soft-delete: some do schema, mas os valores já gravados ficam preservados\). Campos de sistema não podem ser removidos.
- `crm\_link\_record`: Liga um registro a outro por um campo de relação \(ex.: vincular um contato a uma empresa\). Para relação 'many' adiciona ao conjunto; para 'single' define o alvo. Bulk support: accepts ids, target\_ids for batched execution.
- `crm\_unlink\_record`: Desfaz uma relação. Para relação 'many' remove o target\_id do conjunto; para 'single' limpa o campo \(target\_id opcional\). Bulk support: accepts ids, target\_ids for batched execution.
- `crm\_related\_records`: Resolve os registros relacionados de um registro: segue os campos de relação e devolve os registros-alvo \(todos, ou só de um \`field\`\). Bulk support: accepts ids for batched execution.
- `crm\_move\_stage`: Move um registro de um objeto kanban \(ex.: deal\) para outra etapa do funil. Valida a etapa contra as opções do campo de stage. Bulk support: accepts ids for batched execution.
- `crm\_upload\_file`: Inicia o upload de um arquivo \(até 200 MB\) e devolve uma URL presigned \(\`upload\_url\`\) pra fazer o PUT direto no storage, mais o \`file\_id\`. Depois do PUT, chame crm\_confirm\_upload. Opcional: anexe a um registro com \`object\`+\`record\_id\`. Bulk support: accepts record\_ids for batched execution.
- `crm\_confirm\_upload`: Confirma o upload depois do PUT na upload\_url \(o storage valida o tamanho real\). Marca o arquivo como pronto e contabiliza no uso. Bulk support: accepts file\_ids for batched execution.
- `crm\_upload\_from\_url`: Sobe um arquivo A PARTIR DE UMA URL \(a plataforma baixa e armazena, até 200 MB\) — o jeito do AGENTE subir via API sem segurar os bytes. Devolve o arquivo já pronto. Opcional: anexe a um registro com object+record\_id. Bulk support: accepts record\_ids for batched execution.
- `crm\_list\_files`: Lista os arquivos do CRM \(id, nome, tamanho, status\). Opcionalmente filtra os anexados a um objeto/registro. Bulk support: accepts record\_ids for batched execution.
- `crm\_get\_file`: Metadados de um arquivo \(nome, tamanho, content\_type, status, anexo\). Bulk support: accepts file\_ids for batched execution.
- `crm\_download\_file`: Gera uma URL presigned de download \(GET\) pra um arquivo. A URL expira em alguns minutos. Bulk support: accepts file\_ids for batched execution.
- `crm\_delete\_file`: Remove um ou mais arquivos \(apaga do storage e libera o espaço contabilizado\).
- `crm\_publish\_file`: Torna um arquivo PÚBLICO e devolve uma URL estável \(\`https://api.mcp.ai/f/\<token\>\`\) pra embutir num site \(ex.: thumbnail\). O objeto continua privado no storage, o token é a chave \(revogável com crm\_unpublish\_file\). Egress da visualização pública é contabilizado. Bulk support: accepts file\_ids for ba
- `crm\_unpublish\_file`: Revoga o link público de um arquivo \(o token para de funcionar na hora\). Bulk support: accepts file\_ids for batched execution.
- `crm\_usage`: Uso de storage deste CRM: bytes do banco + bytes de arquivos, total em GB, nº de arquivos e egress acumulado. É a base do que é cobrado \(storage GB-mês + egress\).
- `crm\_list\_accounts`: Lista os CRMs conectados neste install. Retorna cada um com id, rótulo e is\_default \(true quando só há um, não precisa passar \`account\` nas outras tools\).
- `show\_version`: Show the current MCP platform and adapter versions.
- `report\_bug`: Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
- `connect`: Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending\[\]. When credentials are missing, returns connect\_url for the toolkit and per-install URLs.
- `toolkit\_info`: Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
- `marketplace`: The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile \(ev
- `authenticate`: MCP.AI for IDE agents \(Cursor, etc.\): log in in the browser, copy the access token. Best: add it to this server's config as a header \`Authorization: Bearer \<token\>\` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with \{ token: "\<jwt\>" \} after the user pastes

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html