API

La API de gestión para toda tu instancia

Todo lo que hace el dashboard, como REST. Crea connectors, genera herramientas, activa el code mode, emite claves y ejecuta File Search — desde un script, un job de CI o un agente.

Inicio rápido
# a management key from the dashboard or `amcp login --browser`$ export AMCP_API_KEY=amk_live_xxx# the CLI resolves the base URL and auth for you$ amcp api GET /api/connectors$ amcp api POST /api/mcp-servers --data '{"name":"ops"}'# or call the HTTP API directly$ curl -H "Authorization: Bearer $AMCP_API_KEY" \  https://cloud.anythingmcp.com/api/connectors

Autenticación

Dos realms llegan a la API, y ambos respetan tu rol. Elige el que corresponda al llamador.

Sesión (JWT)

Usuarios autenticados en el dashboard. Nada que configurar — el navegador lleva la sesión.

Clave de gestión

Para scripts y agentes. Emite una clave con scope en Ajustes o con `amcp login --browser`, y envíala como Bearer token.

scope — Una clave lleva un scope — management-read o management-admin — y su poder efectivo es el menor entre el scope de la clave y el rol del propietario. Las claves de agente son read-only por defecto.

Qué puedes llamar

Más de 200 operaciones, agrupadas por recurso. Explora el esquema completo y siempre actualizado en la referencia interactiva.

Connectors

/api/connectors

Crea connectors e importa herramientas desde OpenAPI, WSDL, GraphQL, Postman, cURL o HAR — o descúbrelas desde un MCP server.

Tools

/api/connectors/:id/tools

Lista, crea, actualiza y elimina las herramientas que expone un connector, con sus esquemas de entrada.

MCP servers

/api/mcp-servers

Crea servers, asigna herramientas y roles, y cambia el code mode entre off, tools e inline.

Adapters

/api/adapters

Importa desde el catálogo integrado de connectors listos para usar por slug.

API keys

/api/mcp-keys

Emite, lista y revoca claves MCP y con scope de gestión — self-service, ligadas a tu cuenta.

File Search

/api/file-search

Gestiona spaces y carpetas buscables para que los agentes recuperen de tus documentos.

Convenciones

Base URL

cloud.anythingmcp.com en Cloud, o tu propio host en self-hosted. La CLI la resuelve por ti.

Cabecera de auth

Authorization: Bearer <key>. El mismo guard acepta un JWT de sesión.

Formato

JSON de entrada, JSON de salida. Envía un body con --data (CLI) o Content-Type: application/json (HTTP).

Scoping

Cada consulta queda limitada a tu organización; una clave nunca alcanza los datos de otro tenant.

Rate limit

300 solicitudes por minuto y por clave por defecto, ajustable por el operador. Un 429 significa que frenes.

Errores

Códigos de estado HTTP estándar; 401 auth incorrecta o ausente, 403 scope o rol demasiado bajo, 404 no encontrado.

Construye sobre la API

Consigue una clave, abre la referencia interactiva y programa tu instancia de principio a fin.