Listar servidores MCP

GET

/v1/org/{org_id}/mcp

mcp.view — OWNER ADMIN OPERATOR VIEWER

Opcionalmente filtrado por agente / huérfanos / archivados.

Autorizaciones

bearer

Token de servicio (kjtk_live_…), creado desde el panel en Ajustes → Tokens de servicio. Pertenece a una organización y lleva sus propios permisos.

Tipo

HTTP (bearer)

o

JWT

Sesión de una persona en el panel. No sirve para integrar.

Tipo

HTTP (bearer)

Parámetros

Parámetros de la ruta

org_id*

Tipo

number

Requerido

Parámetros de consulta

agent_id

Restrict to servers assigned to this agent (handy for the per-agent view).

Tipo

number

Mínimo

1

unassigned

When true, only return servers with zero assignments. Default false.

Tipo

boolean

archived

When true, return ONLY archived (soft-deleted) servers. Default false → live only.

Tipo

boolean

search

Free-text search across name + description (case-insensitive substring).

Tipo

string

transport

Transport kind(s) to keep (STDIO / SSE / HTTP). Repeat the param or pass a CSV.

Tipo

array

sort_by

Sort column.

Tipo

string

Valores válidos

"updated_at""name""created_at"

sort_dir

Sort direction.

Tipo

string

Valores válidos

"asc""desc"

limit

Page size (1-200). Default 50.

Tipo

number

Mínimo

1

Máximo

200

offset

Offset (>= 0). Default 0.

Tipo

number

Mínimo

0

Respuestas

Content-Type

application/json

{

  

"rows": [

  

  

{

  

  

  

"id": 1,

  

  

  

"name": "github",

  

  

  

"description": "Lee repos, crea issues",

  

  

  

"transport": "STDIO",

  

  

  

"command": "string",

  

  

  

"args": [

  

  

  

  

"string"

  

  

  

],

  

  

  

"url": "string",

  

  

  

"auth": [

  

  

  

  

[

  

  

  

  

  

"GITHUB_TOKEN"

  

  

  

  

]

  

  

  

],

  

  

  

"assignment_count": 3,

  

  

  

"agents": [

  

  

  

  

{

  

  

  

  

  

"id": 5,

  

  

  

  

  

"name": "Captain",

  

  

  

  

  

"avatar_url": "string"

  

  

  

  

}

  

  

  

],

  

  

  

"created_by": 0,

  

  

  

"created_at": "string",

  

  

  

"updated_at": "string",

  

  

  

"archived_at": "string"

  

  

}

  

],

  

"total": 23,

  

"limit": 50,

  

"offset": 0

}

GET

/v1/org/{org_id}/mcp

Pruébalo

Autorización

bearer

Variables

Clave

Valor

org_id*

agent_id

unassigned

archived

search

transport

sort_by

sort_dir

limit

offset

Ejemplos