---
title: "Servidor MCP — transporte JSON-RPC (Streamable HTTP) sobre la superficie pública"
method: POST
path: "/mcp"
tags: ["MCP"]
---

# Servidor MCP — transporte JSON-RPC (Streamable HTTP) sobre la superficie pública

`POST /mcp`

## Request

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

El servidor MCP de Meteor, hablando JSON-RPC sobre Streamable HTTP. No se llama a mano: se configura como servidor MCP en Claude, Cursor, Windsurf o tu propio agente, y el cliente hace el handshake solo. Requiere una API key con el scope `mcp:use`, **y además el scope de cada tool** que quiera usar: el catálogo se filtra por la key, así que una tool sin scope simplemente no aparece.

## Response `201`

- McpJsonRpcResponseDto
  - `error` McpJsonRpcErrorDto
    - `code` number, required: Código de error JSON-RPC (`-32601` método desconocido, `-32603` interno, …).
    - `data` object: Detalle opcional del error. Su forma la define quien lo emite.
    - `message` string, required
  - `id` union, required: El mismo `id` que mandaste en la petición. Es `null` cuando el servidor no pudo siquiera leerlo (petición malformada).
    - string
    - number
  - `jsonrpc` '2.0', required
  - `result` object: Resultado del método invocado, presente solo si no hubo error. Su forma la define la especificación de MCP según el método: `initialize` devuelve las capacidades del servidor, `tools/list` el catálogo de tools que alcanzan los scopes de tu key, `tools/call` el contenido que produjo la tool.

## 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.
- `409`: La operación entra en conflicto con el estado actual o con un Idempotency-Key en uso. No reintentes con el mismo key y un body distinto.
- `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)