Herramientas y el servidor MCP

CommandAGI aloja un servidor Model Context Protocol en https://api.commandagi.com/mcp. Apunta Claude Code, Claude Desktop, o cualquier cliente MCP hacia él con una clave de API cagi_, y podrá lanzar y comandar hilos de agente, capturar y bifurcar instantáneas, gestionar disparadores, y leer/escribir en tu Drive — cada herramienta se redirige a las mismas rutas REST, así que los permisos, la facturación y la auditoría son idénticos a llamar a la API tú mismo.

# Claude Code / Claude Desktop — add CommandAGI as an MCP server.
claude mcp add --transport http commandagi https://api.commandagi.com/mcp \
  --header "Authorization: Bearer cagi_YOUR_KEY"

{
  "mcpServers": {
    "commandagi": {
      "type": "http",
      "url": "https://api.commandagi.com/mcp",
      "headers": { "Authorization": "Bearer cagi_YOUR_KEY" }
    }
  }
}

El catálogo es grande, así que los agentes (y tú) no lo cargan todo de una vez — search_tools busca por palabra clave en todo el conjunto y devuelve solo las herramientas que coinciden, manteniendo el contexto reducido. Pide «instantánea» y obtienes las herramientas de instantáneas, nada más.

Para cualquier cosa más allá de una sola llamada, run_code permite que un agente escriba TypeScript contra un SDK cagi tipado y lo ejecute en un sandbox efímero — iterando, ramificando y encadenando docenas de llamadas a herramientas en un solo turno en lugar de un intercambio por paso.

// run_code — write TS against a typed `cagi` SDK; it runs server-side
// and can chain many calls in one turn.
const threads = await cagi.threads.list({ status: "running" });
for (const t of threads) {
  const obs = await cagi.call("observe", { threadId: t.id });
  // …decide, then act
}

• REST — llama a cualquier endpoint directamente (referencia de la API).
• MCP — expón las herramientas a un cliente MCP, como arriba.
• Dentro del agente — las mismas herramientas son de las que un agente elige mientras trabaja, mostradas por relevancia.