Tools - Otros

Esta pagina documenta los tools MCP agrupados por dominio que no tienen pagina propia.

---

Leads (CRM)

list_leads

Lista leads del CRM con paginacion y filtros opcionales.

Parametros:

Nombre	Tipo	Requerido	Descripcion
page	number	No	Numero de pagina (defecto: 1)
limit	number	No	Elementos por pagina (defecto: 50, max: 100)
search	string	No	Buscar por nombre, email, telefono o empresa
source	string	No	Filtrar por origen del lead (ej: linkedin, manual, api)
funnelId	string (UUID)	No	Filtrar por funnel
stageId	string (UUID)	No	Filtrar por etapa del funnel

Ejemplo:

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

---

get_lead

Obtiene un lead por ID, incluyendo tags, etapas de funnel y otras relaciones.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del lead

Ejemplo:

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

---

create_lead

Crea un nuevo lead en el CRM. El nombre es obligatorio.

Parametros:

Nombre	Tipo	Requerido	Descripcion
name	string	Si	Nombre del lead
email	string	No	Direccion de email
phone	string	No	Numero de telefono
company	string	No	Nombre de la empresa
position	string	No	Cargo/posicion
source	string	No	Origen (ej: linkedin, tiktok, instagram, manual, api, import)
notes	string	No	Notas adicionales

Ejemplo:

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

---

update_lead

Actualiza los campos de un lead existente. Solo los campos proporcionados se actualizan.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del lead
name	string	No	Nombre actualizado
email	string	No	Email actualizado
phone	string	No	Telefono actualizado
company	string	No	Empresa actualizada
position	string	No	Cargo actualizado
notes	string	No	Notas actualizadas

Ejemplo:

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

---

delete_lead

Elimina permanentemente un lead del CRM por su ID.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del lead a eliminar

Ejemplo:

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

---

move_lead_stage

Mueve un lead a una etapa diferente dentro de un funnel.

Parametros:

Nombre	Tipo	Requerido	Descripcion
leadId	string (UUID)	Si	ID del lead
funnelId	string (UUID)	Si	ID del funnel destino
stageId	string (UUID)	Si	ID de la etapa destino

Ejemplo:

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

Respuesta:

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

---

Documentos

list_documents

Lista documentos con paginacion y filtros opcionales.

Parametros:

Nombre	Tipo	Requerido	Descripcion
page	number	No	Numero de pagina (defecto: 1)
limit	number	No	Elementos por pagina (defecto: 50, max: 100)
search	string	No	Buscar por titulo
categoryId	string (UUID)	No	Filtrar por categoria
projectId	string (UUID)	No	Filtrar por proyecto

Ejemplo:

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

---

list_document_categories

Lista todas las categorias de documentos con conteo de documentos por categoria.

Parametros:

Este tool no requiere parametros.

Ejemplo:

{}

Respuesta:

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

---

Tags

list_tags

Lista todos los tags del CRM, incluyendo el conteo de leads asociados a cada tag.

Parametros:

Este tool no requiere parametros.

Ejemplo:

{}

Respuesta:

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

---

create_tag

Crea un nuevo tag para organizar leads y work items. El nombre debe ser unico.

Parametros:

Nombre	Tipo	Requerido	Descripcion
name	string	Si	Nombre del tag (unico)
color	string	No	Color en formato hex (ej: #ff5733)

Ejemplo:

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

---

delete_tag

Elimina permanentemente un tag por ID. Esto elimina el tag de todos los leads asociados.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del tag a eliminar

Ejemplo:

{
  "id": "tag-001"
}

---

Funnels

list_funnels

Lista todos los funnels de ventas, incluyendo sus etapas.

Parametros:

Este tool no requiere parametros.

Ejemplo:

{}

---

get_funnel

Obtiene un funnel por ID, incluyendo todas sus etapas y su configuracion.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del funnel

Ejemplo:

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

---

Ideas (Idea Hub)

list_idea_items

Lista items del Idea Hub (ideas y todos) con paginacion y filtros.

Parametros:

Nombre	Tipo	Requerido	Descripcion
page	number	No	Numero de pagina (defecto: 1)
limit	number	No	Elementos por pagina (defecto: 50, max: 100)
type	string	No	Filtrar por tipo: idea, todo
status	string	No	Filtrar por estado: active, archived, pending, done, blocked
ownerUserId	string	No	Filtrar por propietario
projectId	string (UUID)	No	Filtrar por proyecto
search	string	No	Buscar por titulo/descripcion
dueDate	string	No	Filtrar por fecha limite
discussed	boolean	No	Filtrar por flag de discusion

Ejemplo:

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

---

get_idea_item

Obtiene un item del Idea Hub por ID, incluyendo enlaces de trazabilidad.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item

Ejemplo:

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

---

create_idea_item

Crea un nuevo item en el Idea Hub.

Parametros:

Nombre	Tipo	Requerido	Descripcion
title	string	Si	Titulo del item
type	string	Si	Tipo: idea o todo
status	string	No	Estado inicial: active, archived, pending, done, blocked
projectId	string (UUID) o null	No	Proyecto asociado (usa el de sesion como fallback)
description	string o null	No	Descripcion
ownerUserId	string o null	No	ID del usuario propietario
dueDate	string o null	No	Fecha limite (ISO 8601)
metadata	object	No	Metadatos arbitrarios

Ejemplo:

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

---

update_idea_item

Actualiza un item existente del Idea Hub. Solo los campos proporcionados se modifican.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item
title	string	No	Nuevo titulo
type	string	No	Nuevo tipo: idea, todo
status	string	No	Nuevo estado
projectId	string (UUID) o null	No	Nuevo proyecto
description	string o null	No	Nueva descripcion
ownerUserId	string o null	No	Nuevo propietario
dueDate	string o null	No	Nueva fecha limite
metadata	object	No	Nuevos metadatos
discussed	boolean	No	Marcar como discutido

Ejemplo:

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

---

delete_idea_item

Elimina un item del Idea Hub por ID.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item

Ejemplo:

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

---

set_idea_item_status

Actualiza el estado de un item del Idea Hub.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item
status	string	Si	Nuevo estado: active, archived, pending, done, blocked

Ejemplo:

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

---

assign_idea_item_owner

Asigna o quita el propietario de un item del Idea Hub.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item
ownerUserId	string o null	Si	ID del usuario propietario (null para quitar)

Ejemplo:

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

Descubrir IDs de usuario

Usa list_members para obtener los IDs de usuario de los miembros de tu organizacion antes de asignar propietarios.

---

set_idea_item_due_date

Establece o quita la fecha limite de un item del Idea Hub.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item
dueDate	string o null	Si	Fecha limite ISO 8601 (null para quitar)

Ejemplo:

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

---

toggle_idea_item_discussed

Marca o desmarca el flag de "discutido" de un item del Idea Hub.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item
discussed	boolean	Si	true para marcar como discutido, false para desmarcar

Ejemplo:

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

---

promote_idea_item

Promueve un item del Idea Hub a un work item y crea un enlace de trazabilidad entre ambos.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item a promover
workItemType	string	Si	Tipo del work item: task, story, feature, epic
title	string	Si	Titulo del work item resultante
description	string	No	Descripcion del work item
priority	string	No	Prioridad: low, medium, high, urgent
boardId	string (UUID)	Si	Board destino
boardColumnId	string (UUID)	Si	Columna inicial
projectId	string (UUID)	No	Proyecto (usa el del idea item o sesion como fallback)
parentId	string (UUID)	No	Work item padre
notes	string	No	Notas de la promocion
promotedBy	string	No	ID del usuario que promueve

Ejemplo:

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

Respuesta:

{
  "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

Obtiene los enlaces de trazabilidad de un item del Idea Hub (work items promovidos, feedback vinculado, etc).

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del idea item

Ejemplo:

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

---

link_feedback_to_idea_item

Crea un enlace de trazabilidad entre un item del Idea Hub y un item de feedback.

Parametros:

Nombre	Tipo	Requerido	Descripcion
ideaItemId	string (UUID)	Si	ID del idea item
feedbackItemId	string (UUID)	Si	ID del feedback item
metadata	object	No	Metadatos del enlace

Ejemplo:

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

---

unlink_feedback_from_idea_item

Elimina el enlace de trazabilidad entre un idea item y un feedback item.

Parametros:

Nombre	Tipo	Requerido	Descripcion
ideaItemId	string (UUID)	Si	ID del idea item
feedbackItemId	string (UUID)	Si	ID del feedback item

Ejemplo:

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

---

Dependencias

get_work_item_dependencies

Obtiene todas las dependencias y dependientes de un work item.

• Dependencies = lo que bloquea este item
• Dependents = lo que este item bloquea

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del work item

Ejemplo:

{
  "id": "wi-001"
}

Respuesta:

{
  "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

Anade una dependencia a un work item (marca que esta bloqueado por otro item). No se puede crear una dependencia circular (un item no puede depender de si mismo).

Parametros:

Nombre	Tipo	Requerido	Descripcion
workItemId	string (UUID)	Si	ID del work item bloqueado
blockedByWorkItemId	string (UUID)	Si	ID del work item que lo bloquea

Ejemplo:

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

---

remove_work_item_dependency

Elimina una dependencia de un work item.

Parametros:

Nombre	Tipo	Requerido	Descripcion
workItemId	string (UUID)	Si	ID del work item
blockedByWorkItemId	string (UUID)	Si	ID del work item bloqueante a eliminar

Ejemplo:

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

---

get_dependencies_batch

Obtiene dependencias y dependientes para multiples work items en una sola llamada.

Parametros:

Nombre	Tipo	Requerido	Descripcion
workItemIds	string[] (UUID)	Si	Lista de IDs de work items

Ejemplo:

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

Respuesta:

{
  "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": []
    }
  ]
}

---

IA y sesiones

record_ai_session

Registra el consumo de tokens y coste de una sesion de IA asociada a un work item. Usa este tool al terminar el trabajo sobre una tarea para rastrear el consumo de recursos de IA.

Parametros:

Nombre	Tipo	Requerido	Descripcion
workItemId	string (UUID)	Si	ID del work item asociado
model	string	Si	Modelo de IA usado (ej: claude-opus-4-6, claude-sonnet-4-5-20250929)
provider	string	No	Proveedor de IA (defecto: openai)
inputTokens	number	Si	Tokens de entrada consumidos
outputTokens	number	Si	Tokens de salida consumidos
totalTokens	number	Si	Total de tokens (input + output)
estimatedCost	number	No	Coste estimado en USD (calculado automaticamente si es posible)
durationMs	number	No	Duracion de la sesion en milisegundos
sessionType	string	No	Tipo de sesion (defecto: implement)
metadata	object	No	Metadatos adicionales (ej: { taskId: "A-T-48", skill: "implement" })

Ejemplo:

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

---

get_ai_sessions

Obtiene el historial de sesiones de IA de un work item, con un resumen agregado opcional de tokens totales, coste y duracion.

Parametros:

Nombre	Tipo	Requerido	Descripcion
workItemId	string (UUID)	Si	ID del work item
includeSummary	boolean	No	Incluir resumen agregado (defecto: true)

Ejemplo:

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

Respuesta:

{
  "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 si un proveedor de IA tiene cuota disponible (tokens, coste, peticiones). Devuelve si el uso esta permitido y la capacidad restante.

Parametros:

Nombre	Tipo	Requerido	Descripcion
provider	string	Si	Proveedor de IA (ej: anthropic, openai)

Ejemplo:

{
  "provider": "anthropic"
}

---

get_quota_usage

Obtiene el uso actual de cuota para un proveedor de IA. Devuelve datos de uso por periodo activo (diario, semanal, mensual) incluyendo tokens, coste y peticiones.

Parametros:

Nombre	Tipo	Requerido	Descripcion
provider	string	No	Proveedor de IA. Si se omite, devuelve uso de todos los proveedores

Ejemplo:

{
  "provider": "anthropic"
}

---

Miembros

list_members

Lista todos los miembros del workspace actual. Devuelve userId, name, email, image y role de cada miembro.

Parametros:

Este tool no requiere parametros.

Ejemplo:

{}

Respuesta:

[
  {
    "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"
  }
]

Descubrir IDs de usuario

Usa este tool para obtener los IDs de usuario antes de asignar work items o idea items a personas concretas.

---

Milestones (Metas)

list_milestones

Lista todos los milestones de un proyecto, incluyendo estadisticas de progreso. Usa el projectId de la sesion MCP si no se proporciona.

Parametros:

Nombre	Tipo	Requerido	Descripcion
projectId	string (UUID)	No	ID del proyecto (usa el de sesion como fallback)

Ejemplo:

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

---

get_milestone

Obtiene un milestone por ID, incluyendo sus work items vinculados y estadisticas de progreso.

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone

Ejemplo:

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

---

get_milestone_progress

Obtiene estadisticas de progreso de un milestone (items totales, completados, porcentaje).

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone

Ejemplo:

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

---

create_milestone

Crea un nuevo milestone en un proyecto. Opcionalmente vincula work items al crearlo. Usa el projectId de la sesion si no se proporciona.

Parametros:

Nombre	Tipo	Requerido	Descripcion
projectId	string (UUID)	No	ID del proyecto (usa el de sesion como fallback)
title	string	Si	Titulo del milestone
description	string	No	Descripcion
priority	string	No	Prioridad: low, medium, high, urgent (defecto: medium)
targetDate	string	No	Fecha objetivo (ISO 8601, ej: 2026-03-15)
workItemIds	string[] (UUID)	No	Work items a vincular al crearlo

Ejemplo:

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

Respuesta:

{
  "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

Actualiza un milestone existente. Solo los campos proporcionados se modifican.

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone
title	string	No	Nuevo titulo
description	string o null	No	Nueva descripcion (null para limpiar)
status	string	No	Nuevo estado: planned, in_progress, completed, on_hold, cancelled
priority	string	No	Nueva prioridad: low, medium, high, urgent
targetDate	string o null	No	Nueva fecha objetivo (null para limpiar)

Ejemplo:

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

---

delete_milestone

Elimina un milestone por ID. Tambien elimina todas las asociaciones con work items.

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone

Ejemplo:

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

---

add_work_items_to_milestone

Vincula uno o mas work items a un milestone. Los duplicados se ignoran silenciosamente.

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone
workItemIds	string[] (UUID)	Si	Lista de IDs de work items (minimo 1)

Ejemplo:

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

Respuesta:

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

---

remove_work_item_from_milestone

Desvincula un work item de un milestone.

Parametros:

Nombre	Tipo	Requerido	Descripcion
milestoneId	string (UUID)	Si	ID del milestone
workItemId	string (UUID)	Si	ID del work item a desvincular

Ejemplo:

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

Respuesta:

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