jitapi
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 jitapiAñá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 executesRegistrar — 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.
Buscar — Cuando haces una pregunta, JitAPI integra tu consulta y encuentra los endpoints más relevantes mediante similitud de coseno.
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").
Ejecutar — Claude obtiene los esquemas de los endpoints y realiza las llamadas a la API, pasando datos entre pasos.
Herramientas MCP
Herramienta | Descripción |
| Registra una API desde una URL de especificación OpenAPI |
| Lista todas las APIs registradas y su recuento de endpoints |
| Búsqueda semántica entre endpoints usando lenguaje natural |
| Encuentra endpoints relevantes con resolución de dependencias y esquemas completos |
| Obtiene el esquema completo para un endpoint específico |
| Ejecuta una única llamada a la API con autenticación, parámetros de ruta, parámetros de consulta y cuerpo |
| Configura la autenticación (clave de API, token bearer, autenticación básica) |
| Elimina una API registrada y todos sus datos |
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:
SO | Ruta de configuración |
macOS |
|
Windows |
|
Linux |
|
{
"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:
Proveedor | Calidad | Configuración |
Local (predeterminado) | Buena | Nada: funciona inmediatamente |
Voyage AI (recomendado) | Excelente |
|
OpenAI | Excelente |
|
Cohere | Muy buena |
|
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 openweatherTipos 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 pasarcredentialdirectamente, los secretos se almacenan como JSON en texto plano en~/.jitapi/auth.json(permisos de archivo0600, directorio0700). Para uso en producción, prefiere el enfoqueenv_var.
Variables de entorno
Variable | Requerido | Descripción |
| No | Clave de API de Voyage AI (proveedor en la nube recomendado) |
| No | Clave de API de OpenAI (proveedor en la nube alternativo) |
| No | Clave de API de Cohere (proveedor en la nube alternativo) |
| No | Directorio de datos (predeterminado: |
| No | DEBUG, INFO, WARNING, ERROR (predeterminado: INFO) |
Desarrollo
git clone https://github.com/nk3750/jitapi.git
cd jitapi
pip install -e ".[dev]"
pytest
ruff check src/Licencia
MIT
Available Tools
8 toolscall_apiB
Execute an API call. Make sure authentication is configured first.
Inputs: api_id (required), endpoint_id (required), path_params, query_params, +1 more.
delete_apiA
Delete a registered API and all its data including endpoints, embeddings, dependency graph, and authentication credentials.
Inputs: api_id (required).
get_endpoint_schemaB
Get the full schema for a specific endpoint. Use this to get detailed parameter and response information.
Inputs: api_id (required), endpoint_id (required).
get_workflowA
Get relevant endpoints with dependency resolution and full schemas for accomplishing a task. Returns search results expanded with their dependencies so you can plan and execute the right API calls in the right order. After reviewing the results, use call_api to execute each step.
Inputs: query (required), api_id (required), max_steps.
list_apisB
List all registered APIs with their basic information.
Inputs: no named parameters.
register_apiA
Register a new API by ingesting its OpenAPI specification. This parses the spec, builds a dependency graph, and creates searchable embeddings.
Inputs: api_id (required), spec_url (required).
search_endpointsA
Search for API endpoints using natural language. Returns semantically similar endpoints based on the query.
Inputs: query (required), api_id, top_k.
set_api_authA
Configure authentication for an API. Supports API key (header or query param) and bearer token auth. Use env_var to reference a secret from an environment variable — the credential is then resolved at request time and never stored on disk.
Inputs: api_id (required), auth_type (required), credential, env_var, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: register/delete/list for API lifecycle management, search_endpoints for discovery, get_endpoint_schema for detailed inspection, get_workflow for task planning with dependencies, set_api_auth for configuration, and call_api for execution. No overlapping functionality.
Consistent snake_case throughout with verb_noun pattern (call_api, delete_api, list_apis, register_api, search_endpoints, get_workflow, get_endpoint_schema, set_api_auth). All use standard CRUD-style verbs (get, list, search, call, set, register, delete).
8 tools is well-scoped for an API management server covering the full lifecycle: registration, listing, deletion, authentication, discovery (search), inspection (schema), planning (workflow), and execution. Each tool earns its place without redundancy.
Covers the core API lifecycle well (register, list, delete, auth, search, call) with helpful additions like workflow planning. Minor gaps: no get_api for specific API details (only list_apis), no update_api for refreshing specs without full deletion, and no way to remove auth without deleting the entire API.
Maintenance
Related MCP Connectors
Turn any task into the right API calls: discover, evaluate, and integrate public APIs.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Connect ChatGPT or Claude to your CRM, store or shipping API. Keys stay out of the chat.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceBridges Claude Code to a Cloud Orchestrator API, providing access to multi-AI consensus, web search, code execution sandboxes, long-term memory, knowledge graphs, deployment management, and 20+ integrated AI and developer tools.28-
- AlicenseNot gradedqualityDmaintenanceA standalone proxy that transforms any OpenAPI or Swagger-described REST API into an MCP server by mapping API operations to executable MCP tools. It enables AI clients to interact with existing web services through automated HTTP requests based on their official documentation.16MIT
- FlicenseNot gradedqualityNot gradedmaintenanceUniversal AI API Orchestrator. 850 tools across 53 services under a single MCP interface. Connect Claude, GPT, or Gemini to Stripe, Slack, GitHub, LinkedIn, Cloudflare, Shopify, Twilio, and 46 more via natural language. $0.10/execution, no subscription. Patent Pending.274 npm5-
- AlicenseAqualityCmaintenanceTurn any OpenAPI spec into MCP tools for Claude — instantly. Point mcp-openapi at any OpenAPI 3.x spec and Claude can call every endpoint through natural language. No custom integration code. No manual tool definitions. One line of config.240 npm1MIT