Ferramentas - Outras

Esta página documenta as ferramentas MCP agrupadas por domínio que não possuem página própria.

---

Leads (CRM)

list_leads

Lista leads do CRM com paginação e filtros opcionais.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
page	number	Não	Número da página (padrão: 1)
limit	number	Não	Itens por página (padrão: 50, máx.: 100)
search	string	Não	Buscar por nome, e-mail, telefone ou empresa
source	string	Não	Filtrar pela origem do lead (ex.: linkedin, manual, api)
funnelId	string (UUID)	Não	Filtrar por funil
stageId	string (UUID)	Não	Filtrar por etapa do funil

Exemplo:

{
  "search": "Juan",
  "source": "linkedin",
  "limit": 20
}

---

get_lead

Obtém um lead por ID, incluindo tags, etapas do funil e outras relações.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do lead

Exemplo:

{
  "id": "lead-uuid-001"
}

---

create_lead

Cria um novo lead no CRM. O nome é obrigatório.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do lead
email	string	Não	Endereço de e-mail
phone	string	Não	Número de telefone
company	string	Não	Nome da empresa
position	string	Não	Cargo/posição
source	string	Não	Origem (ex.: linkedin, tiktok, instagram, manual, api, import)
notes	string	Não	Observações adicionais

Exemplo:

{
  "name": "Ana Garcia",
  "email": "[email protected]",
  "company": "Empresa SL",
  "source": "linkedin"
}

---

update_lead

Atualiza os campos de um lead existente. Apenas os campos informados são atualizados.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do lead
name	string	Não	Nome atualizado
email	string	Não	E-mail atualizado
phone	string	Não	Telefone atualizado
company	string	Não	Empresa atualizada
position	string	Não	Cargo atualizado
notes	string	Não	Observações atualizadas

Exemplo:

{
  "id": "lead-uuid-001",
  "position": "CTO",
  "notes": "Interesada en plan enterprise"
}

---

delete_lead

Exclui permanentemente um lead do CRM pelo ID.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do lead a excluir

Exemplo:

{
  "id": "lead-uuid-001"
}

---

move_lead_stage

Move um lead para uma etapa diferente dentro de um funil.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
leadId	string (UUID)	Sim	ID do lead
funnelId	string (UUID)	Sim	ID do funil de destino
stageId	string (UUID)	Sim	ID da etapa de destino

Exemplo:

{
  "leadId": "lead-uuid-001",
  "funnelId": "funnel-uuid-001",
  "stageId": "stage-uuid-003"
}

Resposta:

{
  "success": true,
  "previousStageId": "stage-uuid-002",
  "currentStageId": "stage-uuid-003",
  "lead": { ... }
}

---

Documentos

list_documents

Lista documentos com paginação e filtros opcionais.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
page	number	Não	Número da página (padrão: 1)
limit	number	Não	Itens por página (padrão: 50, máx.: 100)
search	string	Não	Buscar por título
categoryId	string (UUID)	Não	Filtrar por categoria
projectId	string (UUID)	Não	Filtrar por projeto

Exemplo:

{
  "search": "changelog",
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

---

list_document_categories

Lista todas as categorias de documentos com a contagem de documentos por categoria.

Parâmetros:

Esta ferramenta não requer parâmetros.

Exemplo:

{}

Resposta:

[
  {
    "id": "cat-001",
    "name": "Changelogs",
    "documentCount": 12
  },
  {
    "id": "cat-002",
    "name": "Arquitectura",
    "documentCount": 5
  }
]

---

Tags

list_tags

Lista todas as tags do CRM, incluindo a contagem de leads associados a cada tag.

Parâmetros:

Esta ferramenta não requer parâmetros.

Exemplo:

{}

Resposta:

[
  {
    "id": "tag-001",
    "name": "VIP",
    "color": "#ff5733",
    "leadCount": 8
  }
]

---

create_tag

Cria uma nova tag para organizar leads e itens de trabalho. O nome deve ser único.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome da tag (único)
color	string	Não	Cor em formato hexadecimal (ex.: #ff5733)

Exemplo:

{
  "name": "Enterprise",
  "color": "#3498db"
}

---

delete_tag

Exclui permanentemente uma tag pelo ID. Isso remove a tag de todos os leads associados.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID da tag a excluir

Exemplo:

{
  "id": "tag-001"
}

---

Funis

list_funnels

Lista todos os funis de vendas, incluindo suas etapas.

Parâmetros:

Esta ferramenta não requer parâmetros.

Exemplo:

{}

---

get_funnel

Obtém um funil por ID, incluindo todas as suas etapas e configurações.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do funil

Exemplo:

{
  "id": "funnel-uuid-001"
}

---

Ideias (Idea Hub)

list_idea_items

Lista itens do Idea Hub (ideias e todos) com paginação e filtros.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
page	number	Não	Número da página (padrão: 1)
limit	number	Não	Itens por página (padrão: 50, máx.: 100)
type	string	Não	Filtrar por tipo: idea, todo
status	string	Não	Filtrar por status: active, archived, pending, done, blocked
ownerUserId	string	Não	Filtrar por responsável
projectId	string (UUID)	Não	Filtrar por projeto
search	string	Não	Buscar por título/descrição
dueDate	string	Não	Filtrar por data limite
discussed	boolean	Não	Filtrar pela marcação de discussão

Exemplo:

{
  "type": "idea",
  "status": "active",
  "limit": 20
}

---

get_idea_item

Obtém um item do Idea Hub por ID, incluindo links de rastreabilidade.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia

Exemplo:

{
  "id": "idea-uuid-001"
}

---

create_idea_item

Cria um novo item no Idea Hub.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
title	string	Sim	Título do item
type	string	Sim	Tipo: idea ou todo
status	string	Não	Status inicial: active, archived, pending, done, blocked
projectId	string (UUID) ou null	Não	Projeto associado (usa o da sessão como alternativa)
description	string ou null	Não	Descrição
ownerUserId	string ou null	Não	ID do usuário responsável
dueDate	string ou null	Não	Data limite (ISO 8601)
metadata	object	Não	Metadados arbitrários

Exemplo:

{
  "title": "Integrar notificaciones push",
  "type": "idea",
  "description": "Enviar notificaciones cuando se completan work items"
}

---

update_idea_item

Atualiza um item existente do Idea Hub. Apenas os campos informados são modificados.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia
title	string	Não	Novo título
type	string	Não	Novo tipo: idea, todo
status	string	Não	Novo status
projectId	string (UUID) ou null	Não	Novo projeto
description	string ou null	Não	Nova descrição
ownerUserId	string ou null	Não	Novo responsável
dueDate	string ou null	Não	Nova data limite
metadata	object	Não	Novos metadados
discussed	boolean	Não	Marcar como discutido

Exemplo:

{
  "id": "idea-uuid-001",
  "status": "done",
  "discussed": true
}

---

delete_idea_item

Exclui um item do Idea Hub pelo ID.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia

Exemplo:

{
  "id": "idea-uuid-001"
}

---

set_idea_item_status

Atualiza o status de um item do Idea Hub.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia
status	string	Sim	Novo status: active, archived, pending, done, blocked

Exemplo:

{
  "id": "idea-uuid-001",
  "status": "archived"
}

---

assign_idea_item_owner

Atribui ou remove o responsável por um item do Idea Hub.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia
ownerUserId	string ou null	Sim	ID do usuário responsável (null para remover)

Exemplo:

{
  "id": "idea-uuid-001",
  "ownerUserId": "user-uuid-001"
}

Descobrir IDs de usuário

Use list_members para obter os IDs de usuário dos membros da sua organização antes de atribuir responsáveis.

---

set_idea_item_due_date

Define ou remove a data limite de um item do Idea Hub.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia
dueDate	string ou null	Sim	Data limite ISO 8601 (null para remover)

Exemplo:

{
  "id": "idea-uuid-001",
  "dueDate": "2025-03-15"
}

---

toggle_idea_item_discussed

Marca ou desmarca a indicação de "discutido" de um item do Idea Hub.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia
discussed	boolean	Sim	true para marcar como discutido, false para desmarcar

Exemplo:

{
  "id": "idea-uuid-001",
  "discussed": true
}

---

promote_idea_item

Promove um item do Idea Hub a um item de trabalho e cria um link de rastreabilidade entre ambos.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia a promover
workItemType	string	Sim	Tipo do item de trabalho: task, story, feature, epic
title	string	Sim	Título do item de trabalho resultante
description	string	Não	Descrição do item de trabalho
priority	string	Não	Prioridade: low, medium, high, urgent
boardId	string (UUID)	Sim	Quadro de destino
boardColumnId	string (UUID)	Sim	Coluna inicial
projectId	string (UUID)	Não	Projeto (usa o do item de ideia ou da sessão como alternativa)
parentId	string (UUID)	Não	Item de trabalho pai
notes	string	Não	Observações da promoção
promotedBy	string	Não	ID do usuário que promove

Exemplo:

{
  "id": "idea-uuid-001",
  "workItemType": "task",
  "title": "Implementar notificaciones push",
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "boardColumnId": "col-001",
  "priority": "medium"
}

Resposta:

{
  "source": {
    "id": "idea-uuid-001",
    "type": "idea",
    "status": "active"
  },
  "workItem": {
    "id": "wi-new-001",
    "taskId": "A-T-55",
    "title": "Implementar notificaciones push",
    "type": "task"
  },
  "link": {
    "id": "link-uuid-001",
    "ideaItemId": "idea-uuid-001",
    "workItemId": "wi-new-001",
    "linkType": "promoted_to",
    "createdAt": "2025-02-15T10:00:00.000Z"
  }
}

---

get_idea_item_traceability

Obtém os links de rastreabilidade de um item do Idea Hub (itens de trabalho promovidos, feedback vinculado etc.).

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de ideia

Exemplo:

{
  "id": "idea-uuid-001"
}

---

link_feedback_to_idea_item

Cria um link de rastreabilidade entre um item do Idea Hub e um item de feedback.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
ideaItemId	string (UUID)	Sim	ID do item de ideia
feedbackItemId	string (UUID)	Sim	ID do item de feedback
metadata	object	Não	Metadados do link

Exemplo:

{
  "ideaItemId": "idea-uuid-001",
  "feedbackItemId": "feedback-uuid-001"
}

---

unlink_feedback_from_idea_item

Remove o link de rastreabilidade entre um item de ideia e um item de feedback.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
ideaItemId	string (UUID)	Sim	ID do item de ideia
feedbackItemId	string (UUID)	Sim	ID do item de feedback

Exemplo:

{
  "ideaItemId": "idea-uuid-001",
  "feedbackItemId": "feedback-uuid-001"
}

---

Dependências

get_work_item_dependencies

Obtém todas as dependências e dependentes de um item de trabalho.

• Dependências = o que bloqueia este item
• Dependentes = o que este item bloqueia

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do item de trabalho

Exemplo:

{
  "id": "wi-001"
}

Resposta:

{
  "dependencies": [
    {
      "workItemId": "wi-001",
      "blockedByWorkItemId": "wi-000",
      "createdAt": "2025-02-01T10:00:00.000Z"
    }
  ],
  "dependents": [
    {
      "workItemId": "wi-002",
      "blockedByWorkItemId": "wi-001",
      "createdAt": "2025-02-01T10:00:00.000Z"
    }
  ]
}

---

add_work_item_dependency

Adiciona uma dependência a um item de trabalho (marca que ele está bloqueado por outro item). Não é possível criar uma dependência circular (um item não pode depender de si mesmo).

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
workItemId	string (UUID)	Sim	ID do item de trabalho bloqueado
blockedByWorkItemId	string (UUID)	Sim	ID do item de trabalho que o bloqueia

Exemplo:

{
  "workItemId": "wi-002",
  "blockedByWorkItemId": "wi-001"
}

---

remove_work_item_dependency

Remove uma dependência de um item de trabalho.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
workItemId	string (UUID)	Sim	ID do item de trabalho
blockedByWorkItemId	string (UUID)	Sim	ID do item de trabalho bloqueador a remover

Exemplo:

{
  "workItemId": "wi-002",
  "blockedByWorkItemId": "wi-001"
}

---

get_dependencies_batch

Obtém dependências e dependentes de vários itens de trabalho em uma única chamada.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
workItemIds	string[] (UUID)	Sim	Lista de IDs de itens de trabalho

Exemplo:

{
  "workItemIds": ["wi-001", "wi-002", "wi-003"]
}

Resposta:

{
  "items": [
    {
      "workItemId": "wi-001",
      "dependencies": [],
      "dependents": [{ "workItemId": "wi-002", "blockedByWorkItemId": "wi-001" }]
    },
    {
      "workItemId": "wi-002",
      "dependencies": [{ "workItemId": "wi-002", "blockedByWorkItemId": "wi-001" }],
      "dependents": []
    },
    {
      "workItemId": "wi-003",
      "dependencies": [],
      "dependents": []
    }
  ]
}

---

Armazenamento privado

As ferramentas de armazenamento privado operam sobre arquivos pertencentes à pessoa autenticada. Elas exigem uma chave de API com a permissão MCP indicada e nunca expõem chaves brutas do armazenamento de objetos. Consulte Armazenamento privado para conhecer as cargas REST, os downloads privados e os limites.

Ferramenta	Permissão	Limite
storage_usage	mcp:read	Retorna o uso de bytes e objetos.
storage_list	mcp:read	Até 200 entradas.
storage_read	mcp:read	Limite de resposta de 1 MiB; use o download REST autenticado para arquivos maiores.
storage_write	mcp:write	Limite de carga útil de 1 MiB; informe exatamente um entre content de texto ou base64.
storage_delete	mcp:write	Exclui pelo ID um arquivo próprio.

---

IA e sessões

record_ai_session

Registra o consumo de tokens e o custo de uma sessão de IA associada a um item de trabalho. Use esta ferramenta ao terminar o trabalho em uma tarefa para acompanhar o consumo de recursos de IA.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
workItemId	string (UUID)	Sim	ID do item de trabalho associado
model	string	Sim	Modelo de IA usado (ex.: claude-opus-4-6, claude-sonnet-4-5-20250929)
provider	string	Não	Provedor de IA (padrão: openai)
inputTokens	number	Sim	Tokens de entrada consumidos
outputTokens	number	Sim	Tokens de saída consumidos
totalTokens	number	Sim	Total de tokens (entrada + saída)
estimatedCost	number	Não	Custo estimado em USD (calculado automaticamente quando possível)
durationMs	number	Não	Duração da sessão em milissegundos
sessionType	string	Não	Tipo de sessão (padrão: implement)
metadata	object	Não	Metadados adicionais (ex.: { taskId: "A-T-48", skill: "implement" })

Exemplo:

{
  "workItemId": "wi-001",
  "model": "claude-opus-4-6",
  "provider": "anthropic",
  "inputTokens": 50000,
  "outputTokens": 15000,
  "totalTokens": 65000,
  "durationMs": 180000,
  "sessionType": "implement"
}

---

get_ai_sessions

Obtém o histórico de sessões de IA de um item de trabalho, com um resumo agregado opcional de tokens totais, custo e duração.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
workItemId	string (UUID)	Sim	ID do item de trabalho
includeSummary	boolean	Não	Incluir resumo agregado (padrão: true)

Exemplo:

{
  "workItemId": "wi-001",
  "includeSummary": true
}

Resposta:

{
  "workItemId": "wi-001",
  "taskId": "A-T-37",
  "title": "Implementar login",
  "sessions": [
    {
      "id": "session-001",
      "model": "claude-opus-4-6",
      "provider": "anthropic",
      "inputTokens": 50000,
      "outputTokens": 15000,
      "totalTokens": 65000,
      "estimatedCost": "0.0975",
      "sessionType": "implement",
      "createdAt": "2025-02-15T10:00:00.000Z"
    }
  ],
  "summary": {
    "totalSessions": 1,
    "totalTokens": 65000,
    "totalCost": "0.0975"
  }
}

---

check_quota

Verifica se um provedor de IA possui cota disponível (tokens, custo, solicitações). Retorna se o uso é permitido e a capacidade restante.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
provider	string	Sim	Provedor de IA (ex.: anthropic, openai)

Exemplo:

{
  "provider": "anthropic"
}

---

get_quota_usage

Obtém o uso atual da cota de um provedor de IA. Retorna dados de uso por período ativo (diário, semanal, mensal), incluindo tokens, custo e solicitações.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
provider	string	Não	Provedor de IA. Se omitido, retorna o uso de todos os provedores

Exemplo:

{
  "provider": "anthropic"
}

---

Membros

list_members

Lista todos os membros do espaço de trabalho atual. Retorna userId, name, email, image e role de cada membro.

Parâmetros:

Esta ferramenta não requer parâmetros.

Exemplo:

{}

Resposta:

[
  {
    "userId": "user-001",
    "name": "Javier Lopez",
    "email": "[email protected]",
    "image": "https://...",
    "role": "owner"
  },
  {
    "userId": "user-002",
    "name": "Ana Garcia",
    "email": "[email protected]",
    "image": null,
    "role": "member"
  }
]

Descobrir IDs de usuário

Use esta ferramenta para obter IDs de usuário antes de atribuir itens de trabalho ou itens de ideia a pessoas específicas.

---

Marcos (Metas)

list_milestones

Lista todos os marcos de um projeto, incluindo estatísticas de progresso. Usa o projectId da sessão MCP caso ele não seja informado.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
projectId	string (UUID)	Não	ID do projeto (usa o da sessão como alternativa)

Exemplo:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

---

get_milestone

Obtém um marco por ID, incluindo seus itens de trabalho vinculados e estatísticas de progresso.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco

Exemplo:

{
  "milestoneId": "ms-uuid-001"
}

---

get_milestone_progress

Obtém estatísticas de progresso de um marco (itens totais, concluídos, porcentagem).

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco

Exemplo:

{
  "milestoneId": "ms-uuid-001"
}

---

create_milestone

Cria um novo marco em um projeto. Opcionalmente, vincula itens de trabalho ao criá-lo. Usa o projectId da sessão caso ele não seja informado.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
projectId	string (UUID)	Não	ID do projeto (usa o da sessão como alternativa)
title	string	Sim	Título do marco
description	string	Não	Descrição
priority	string	Não	Prioridade: low, medium, high, urgent (padrão: medium)
targetDate	string	Não	Data-alvo (ISO 8601, ex.: 2026-03-15)
workItemIds	string[] (UUID)	Não	Itens de trabalho a vincular ao criá-lo

Exemplo:

{
  "title": "MVP Autenticacion",
  "description": "Login con Google + email/password funcionando",
  "priority": "high",
  "targetDate": "2025-03-31",
  "workItemIds": ["wi-001", "wi-002", "wi-003"]
}

Resposta:

{
  "id": "ms-uuid-001",
  "title": "MVP Autenticacion",
  "description": "Login con Google + email/password funcionando",
  "status": "planned",
  "priority": "high",
  "targetDate": "2025-03-31T00:00:00.000Z",
  "linkedWorkItems": 3,
  "createdAt": "2025-02-15T10:00:00.000Z"
}

---

update_milestone

Atualiza um marco existente. Apenas os campos informados são modificados.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco
title	string	Não	Novo título
description	string ou null	Não	Nova descrição (null para limpar)
status	string	Não	Novo status: planned, in_progress, completed, on_hold, cancelled
priority	string	Não	Nova prioridade: low, medium, high, urgent
targetDate	string ou null	Não	Nova data-alvo (null para limpar)

Exemplo:

{
  "milestoneId": "ms-uuid-001",
  "status": "in_progress"
}

---

delete_milestone

Exclui um marco pelo ID. Também remove todas as associações com itens de trabalho.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco

Exemplo:

{
  "milestoneId": "ms-uuid-001"
}

---

add_work_items_to_milestone

Vincula um ou mais itens de trabalho a um marco. Duplicados são ignorados silenciosamente.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco
workItemIds	string[] (UUID)	Sim	Lista de IDs de itens de trabalho (mínimo 1)

Exemplo:

{
  "milestoneId": "ms-uuid-001",
  "workItemIds": ["wi-004", "wi-005"]
}

Resposta:

{
  "milestoneId": "ms-uuid-001",
  "linkedCount": 2
}

---

remove_work_item_from_milestone

Desvincula um item de trabalho de um marco.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
milestoneId	string (UUID)	Sim	ID do marco
workItemId	string (UUID)	Sim	ID do item de trabalho a desvincular

Exemplo:

{
  "milestoneId": "ms-uuid-001",
  "workItemId": "wi-004"
}

Resposta:

{
  "removed": true,
  "milestoneId": "ms-uuid-001",
  "workItemId": "wi-004"
}