Catálogo del Workspace

El catálogo es la lista de herramientas que existen en el workspace. Estar en el catálogo significa que la herramienta se puede conectar a un agente, no que algún agente la esté usando — para eso están los endpoints de herramientas de agente .

El id que devuelven estos endpoints es el toolId que se usa en todo lo demás.

Listar Herramientas

GET https://api.platica.mx/v1/tools

Parámetros de consulta

Parámetro	Tipo	Descripción	Requerido
`kind`	string	Filtra por origen: `mcp`, `api`, `integration` o `legacy`	—
`mcpId`	string	Sólo herramientas instaladas desde ese servidor MCP	—
`integrationId`	string	Sólo herramientas de esa API personalizada	—
`workspace`	string	Requerido para API keys multi-workspace	—

Respuesta

{
  "count": 2,
  "tools": [
    {
      "id": "8fK2mQpLxT4vNbRc",
      "name": "mcp_create_issue_a1b2c3",
      "description": "Create a new issue in Linear",
      "kind": "mcp",
      "parameters": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "teamId": { "type": "string" }
        },
        "required": ["title", "teamId"]
      },
      "status": "active",
      "mcpId": "QZPHpckDPC58JIVLQA3Z",
      "mcpToolName": "create_issue",
      "mcpName": "Linear",
      "mcpStatus": "connected",
      "integrationId": null,
      "integrationName": null,
      "integrationStatus": null,
      "installationId": null,
      "providerId": null,
      "providerToolName": null,
      "createdAt": "2026-07-14T18:02:11.410Z",
      "updatedAt": "2026-07-14T18:02:11.410Z"
    },
    {
      "id": "RuzoaswTBBrhutHyKYZn",
      "name": "api_order_lookup",
      "description": "Consulta el estado de un pedido por su folio.",
      "kind": "api",
      "parameters": {
        "type": "object",
        "properties": {
          "orderId": { "type": "string", "description": "Folio del pedido" }
        },
        "required": ["orderId"],
        "additionalProperties": false
      },
      "status": "active",
      "mcpId": null,
      "mcpToolName": null,
      "mcpName": null,
      "mcpStatus": null,
      "integrationId": "RuzoaswTBBrhutHyKYZn",
      "integrationName": "order_lookup",
      "integrationStatus": "enabled",
      "installationId": null,
      "providerId": null,
      "providerToolName": null,
      "createdAt": "2026-07-10T15:41:03.902Z",
      "updatedAt": "2026-07-12T09:18:44.117Z"
    }
  ]
}

Las herramientas vienen ordenadas por fecha de actualización, la más reciente primero.

Campo	Tipo	Descripción
`id`	string	El `toolId`. Se usa para conectarla a un agente.
`name`	string	Nombre técnico que ve el modelo. Se genera solo: `mcp_<herramienta>_<slug>` para MCP, `api_<nombre>` para APIs personalizadas.
`description`	string	Descripción que lee el modelo para decidir cuándo llamarla.
`kind`	string	`mcp`, `api`, `integration` o `legacy`.
`parameters`	objeto	JSON Schema de los argumentos, tal como lo recibe el modelo.
`status`	string	Estado de la herramienta en el catálogo.
`mcpId`, `mcpToolName`, `mcpName`, `mcpStatus`	string \| null	Servidor MCP de origen y nombre original de la herramienta en ese servidor. Sólo con `kind: "mcp"`.
`integrationId`, `integrationName`, `integrationStatus`	string \| null	API personalizada de origen. Sólo con `kind: "api"`.
`installationId`, `providerId`, `providerToolName`	string \| null	App instalada de origen. Sólo con `kind: "integration"`.
`createdAt`, `updatedAt`	string \| null	ISO 8601.

mcpToolName es el nombre original en el servidor MCP, y es el que se pasa a POST /v1/tools/mcp y POST /v1/tools/mcp/{mcpId}/tools/sync — no el name renombrado.

Obtener Herramienta

Devuelve la misma forma que un elemento de la lista, útil cuando sólo necesitas el esquema de parámetros de una herramienta concreta.

GET https://api.platica.mx/v1/tools/{toolId}

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`toolId`	string	Identificador de la herramienta en el catálogo	✓

Respuesta

{
  "id": "8fK2mQpLxT4vNbRc",
  "name": "mcp_create_issue_a1b2c3",
  "description": "Create a new issue in Linear",
  "kind": "mcp",
  "parameters": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "teamId": { "type": "string" }
    },
    "required": ["title", "teamId"]
  },
  "status": "active",
  "mcpId": "QZPHpckDPC58JIVLQA3Z",
  "mcpToolName": "create_issue",
  "mcpName": "Linear",
  "mcpStatus": "connected",
  "integrationId": null,
  "integrationName": null,
  "integrationStatus": null,
  "installationId": null,
  "providerId": null,
  "providerToolName": null,
  "createdAt": "2026-07-14T18:02:11.410Z",
  "updatedAt": "2026-07-14T18:02:11.410Z"
}

Errores

Status	Causa
`404`	La herramienta no existe en el workspace

Consejo

Para saber qué herramientas del catálogo ya tiene un agente concreto, usa GET /v1/agents/{agentId}/tools/available : devuelve este mismo catálogo con un flag isConnected.

Anterior Introducción Siguiente Herramientas de Agente