---
title: "Lista los MCP activos"
method: GET
path: "/mcps/active"
tags: ["Item Links"]
---

# Lista los MCP activos

`GET /mcps/active`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/mcps/active`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Los servidores MCP activos del workspace. Es la vista corta para saber qué hay conectado sin recorrer integración por integración.

## Response `200`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` ActiveMcpResponseDto[], required
    - `activated_at` string, nullable, required: Cuándo se activó en el workspace. `null` si el dato no quedó registrado.
    - `activated_by` number, nullable, required: Quién lo activó. `null` si el usuario ya no existe.
    - `code` string, nullable, required: `@handle` del ítem del MCP. `null` si el ítem ya no existe.
    - `connection_status` string, nullable, required: Resultado de la última prueba de conexión. `null` si nunca se probó.
    - `created_at` string, nullable, required
    - `descripcion` string, required
    - `endpoint_override` string, nullable, required: Endpoint propio del workspace, si sobreescribe al del catálogo.
    - `id` number, required: `id` de la fila de configuración, **no** el id del ítem del MCP.
    - `integration_key` string, nullable, required: Clave de integración: `native_handler` para MCP nativos, `http:<mcp_id>` para los HTTP. `null` en filas legacy sin backfill.
    - `is_active` boolean, required
    - `last_tested_at` string, nullable, required
    - `mcp_data` object, required: Config del MCP: `mcp_type`, `native_handler`, `tools_cache` y `credentials_required`. `credentials_required` son los **nombres** de las credenciales que el MCP pide (la UI los usa para pintar el formulario). Nombres, nunca valores: los valores viven en la columna `credentials`, que no sale por este endpoint.
    - `mcp_id` string, required: ID del ítem del MCP. Es `VARCHAR` en la tabla, aunque referencie un `items.id`.
    - `nombre` string, required: Nombre mostrable, resuelto del ítem, del `mcp_data` o del registro nativo.
    - `updated_at` string, nullable, required
    - `workspace_id` number, required

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/fc6d3aad75de?raw)