JitAPI

Apunta Claude a cualquier API. JitAPI determina qué endpoints llamar y en qué orden, automáticamente.

JitAPI es un servidor MCP que permite a Claude interactuar con cualquier API a partir de su especificación OpenAPI. En lugar de volcar cientos de endpoints en el contexto, JitAPI utiliza búsqueda semántica y un grafo de dependencias para mostrar solo lo necesario; luego, Claude planifica y ejecuta las llamadas.

https://github.com/user-attachments/assets/53f72f89-a41a-4a9c-a688-ec876ea05fbd

El problema

Stripe tiene más de 300 endpoints. GitHub tiene más de 800. Cargar la especificación completa en el contexto de Claude desperdicia tokens y provoca alucinaciones. Escribir un servidor MCP personalizado para cada API que utilizas no es escalable.

JitAPI resuelve esto: registra cualquier especificación OpenAPI una vez y luego pide lo que necesites en lenguaje sencillo. Encuentra los endpoints correctos, resuelve las dependencias entre ellos y permite que Claude ejecute las llamadas.

Related MCP server: OpenAPI to MCP

Inicio rápido

pip install jitapi

Añádelo a tu configuración de Claude Code (.mcp.json):

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Eso es todo. No se requieren claves de API: JitAPI utiliza embeddings locales de forma inmediata.

Luego, en Claude:

You: Register the GitHub API from https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json

Claude: ✓ Registered GitHub v3 REST API — 1,107 endpoints indexed

You: List my repos

Claude: [searches for "list repositories for authenticated user" → finds GET /user/repos → executes]
Here are your repositories: ...

Orquestación de múltiples APIs

La función estrella: registra múltiples APIs y haz preguntas que las abarquen. JitAPI busca en todas las APIs registradas y Claude encadena las llamadas.

You: Register the TMDB API and OpenWeatherMap API
Claude: ✓ Registered both APIs

You: Find the top popular movie on TMDB, then get the weather where it was filmed

Claude: [searches TMDB → GET /movie/popular → GET /movie/{id} for production locations
         → searches OpenWeather → GET /data/2.5/weather with the city]

The #1 popular movie is "Inception", filmed in Los Angeles.
Current weather in LA: 72°F, partly cloudy.

Cómo funciona

Register API                          Ask a question
     │                                      │
     ▼                                      ▼
Parse OpenAPI spec               Embed query → vector search
     │                                      │
     ▼                                      ▼
Build dependency graph           Find relevant endpoints
     │                                      │
     ▼                                      ▼
Embed all endpoints              Expand with dependencies
     │                                      │
     ▼                                      ▼
Store in vector DB               Return schemas → Claude executes

1. Registrar — Analiza una especificación OpenAPI, construye un grafo de dependencias (qué endpoints necesitan datos de qué otros endpoints) y crea embeddings buscables para todos los endpoints.

2. Buscar — Cuando haces una pregunta, JitAPI integra tu consulta y encuentra los endpoints más relevantes mediante similitud de coseno.

3. Expandir — El grafo de dependencias añade cualquier endpoint prerrequisito (por ejemplo, "primero necesitas llamar a GET /users para obtener el user_id para POST /orders").

4. Ejecutar — Claude obtiene los esquemas de los endpoints y realiza las llamadas a la API, pasando datos entre pasos.

Herramientas MCP

Configuración

Claude Code

Crea .mcp.json en el directorio de tu proyecto (o ~/.claude.json para acceso global):

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Claude Desktop

Añádelo a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Proveedores de embeddings

JitAPI funciona de inmediato con embeddings locales (fastembed); no se necesitan claves de API. Para una mejor calidad de búsqueda en APIs grandes, puedes añadir un proveedor de embeddings en la nube:

Establece la clave de API en el bloque env de tu configuración MCP:

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"],
      "env": {
        "VOYAGE_API_KEY": "your-key-here"
      }
    }
  }
}

El proveedor se detecta automáticamente a partir de las variables de entorno disponibles. Prioridad: Voyage AI > OpenAI > Cohere > local.

Autenticación

Configura la autenticación de la API después de registrarla. El enfoque recomendado utiliza variables de entorno para que los secretos nunca se escriban en el disco:

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "OPENWEATHER_API_KEY": "your-key-here"
      }
    }
  }
}

Luego dile a Claude que use la variable de entorno:

You: Set bearer auth for GitHub using env var GITHUB_TOKEN
Claude: [calls set_api_auth with auth_type="bearer", env_var="GITHUB_TOKEN"]
✓ Auth configured for github (from env var $GITHUB_TOKEN)

Con env_var, JitAPI lee el secreto del entorno en el momento de la solicitud; solo se persiste el nombre de la variable de entorno, nunca la credencial en sí.

También puedes pasar credenciales directamente (se almacenarán en ~/.jitapi/auth.json con permisos 0600):

You: Set API key auth for OpenWeather with param name "appid"
Claude: [calls set_api_auth with auth_type="api_key_query", credential="...", param_name="appid"]
✓ Auth configured for openweather

Tipos de autenticación admitidos: bearer, api_key_header, api_key_query, basic.

Nota de seguridad: Al usar env_var, las credenciales se resuelven en tiempo de ejecución y nunca tocan el sistema de archivos. Al pasar credential directamente, los secretos se almacenan como JSON en texto plano en ~/.jitapi/auth.json (permisos de archivo 0600, directorio 0700). Para uso en producción, prefiere el enfoque env_var.

Variables de entorno

Desarrollo

git clone https://github.com/nk3750/jitapi.git
cd jitapi
pip install -e ".[dev]"
pytest
ruff check src/

Licencia

MIT