upAPI MCP
Llama a un catálogo de APIs listas para usar mediante una cuenta y clave de upAPI, sin registrarte en cada servicio upstream. Servidor remoto con inicio de sesión OAuth.
Servidor MCP alojado
npx add-mcp 'https://app.upapi.io/api/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP (https://upapi.io/docs/mcp)
El Protocolo de Contexto de Modelo (MCP) permite que un asistente de IA llame a herramientas. upAPI publica sus operaciones a través de MCP, por lo que una operación se convierte en una herramienta que el asistente puede invocar, con tu clave, tu cuota y los mismos esquemas que la puerta de enlace REST.
Hay dos formas de conectarse, descritas a continuación. Se diferencian en cómo autorizas y en cuánto del catálogo sirven. Para la configuración que debes pegar en un cliente específico, consulta Conectar un cliente MCP.
Servidor alojado [#hosted-server]
https://app.upapi.io/api/mcp habla MCP sobre HTTP transmisible y autoriza mediante OAuth 2.1 con PKCE, contra el mismo sistema de cuentas que el panel de control. Un cliente se conecta iniciando sesión a través de un navegador, por lo que nunca se escribe una clave de API en un archivo de configuración.
Cada solicitud restablece tu identidad a partir del token de acceso, y las llamadas a herramientas se ejecutan exactamente en la ruta que usa el panel de prueba del marketplace: la misma limitación de plan y el mismo medidor. Una sesión de invitado no puede conectarse; consulta Conectar un cliente MCP para saber por qué.
El servidor alojado sirve el catálogo menos las categorías de Redes Sociales y Utilidades: los lectores de perfiles/publicaciones sociales y las dos operaciones email-read-verification-*. Esta es la superficie que los directorios de IA listan públicamente, y esas operaciones leen datos personales de otras personas o automatizan flujos de registro, lo cual es razonable que hagas con tu propia clave, pero no es razonable ofrecerlo al asistente de un desconocido con un clic de OAuth. No van a desaparecer: úsalas en la puerta de enlace REST, en el panel de prueba o a través del servidor local a continuación.
Servidor local [#local-server]
El comando upapi-mcp habla MCP sobre stdio y reenvía cada llamada de herramienta a api.upapi.io con tu clave de API. Se ejecuta en tu máquina, junto al cliente.
Se autentica con la clave en UPAPI_API_KEY y no valida nada por sí mismo: tu clave se verifica en el mismo punto de control de la puerta de enlace que cualquier otra llamada, por lo que una llamada de herramienta MCP se mide y limita exactamente igual que el curl equivalente. Apúntalo a un origen de puerta de enlace diferente con UPAPI_BASE_URL si lo necesitas.
Debido a que lo instalas deliberadamente con tu propia clave, el servidor local sirve el catálogo completo, incluidas las categorías que el servidor alojado retiene.
Cómo se ven las herramientas [#what-the-tools-look-like]
Cada operación pública se convierte en una herramienta, con el esquema de entrada de la operación como su esquema de parámetros. El asistente ve los mismos nombres de campos, tipos y descripciones que el marketplace te muestra, por lo que puede completar argumentos sin adivinar.
Cuántas de esas herramientas se anuncian a la vez es una elección: compact, directory o full, configurado en la URL para el servidor alojado y en UPAPI_TOOL_MODE para el local. Las tres se construyen desde la misma tabla de herramientas, por lo que el modo cambia lo que se lista y nunca lo que es accesible. Consulta Qué herramientas obtienes.
Cada herramienta declara los cuatro indicadores de comportamiento de MCP: readOnlyHint, destructiveHint, idempotentHint y openWorldHint — y describen lo que el trabajador realmente hace, en lugar de lo que sugiere el sufijo .get/.post del slug. openWorldHint es verdadero en cada operación: upAPI es un marketplace, por lo que cada una existe para alcanzar un sistema que upAPI no posee.
El nombre de una herramienta no es el slug: los nombres de MCP deben ser seguros para identificadores, por lo que es el id de la operación: el slug con puntos y guiones reemplazados por guiones bajos. github-trending.get es la herramienta github_trending_get. La descripción de la herramienta nombra el slug al que se asigna y cuánto cuesta una llamada, para que puedas leer estos documentos desde un volcado de tools/list.
Los resultados vuelven como el objeto de salida de la operación, codificado en JSON dentro de un bloque de texto: ninguna herramienta declara un outputSchema, y ninguna devuelve structuredContent. Esto es deliberado: MCP obliga a un servidor que declara un esquema de salida a devolver contenido estructurado coincidente, y estas salidas describen cargas útiles de terceros en vivo, donde un null inesperado convertiría una llamada exitosa en un error de protocolo. Los fallos llegan con el código de error estándar, lo que significa que un asistente puede distinguir "te quedaste sin cuota" de "esa operación no existe" y decir algo útil al respecto.
Costo [#cost]
Las llamadas de herramientas MCP son llamadas ordinarias a la puerta de enlace: consumen las unidades ponderadas de la operación y cuentan contra la misma cuota mensual que tu tráfico de aplicación.
Vale la pena saberlo antes de apuntar un agente al catálogo: un asistente que explora por su cuenta puede gastar mucho más que un script deliberado, y las operaciones más pesadas del catálogo cuestan 20 unidades por llamada. Consulta /api/usage después de una sesión larga, y mantén un ojo en las notificaciones de cuota al 70% y 90%.