onecall-mcp

Un servidor MCP (Model Context Protocol) que expone 10 API públicas sin autenticación y probadas en producción como herramientas para agentes de IA.

Construido sobre onecall. Cero claves de API. Biblioteca estándar de Python. MIT.

weather_current(location)              # wttr.in
weather_forecast(lat, lon, days)       # open-meteo
fx_convert(amount, from, to)           # frankfurter (ECB)
fx_rates(base, symbols)                # frankfurter
crypto_price(ids, vs_currency)         # coingecko
geocode(query, limit)                  # openstreetmap nominatim
country_info(query)                    # REST Countries
time_in_zone(timezone)                 # timeapi.io
hn_front()                             # Hacker News top 10
hn_search(query, limit)                # Hacker News Algolia search

Por qué existe

La mayoría de los agentes de IA necesitan hacer consultas de clima, FX, criptomonedas, geocodificación, hora, país y noticias. Los datos están en la web abierta de forma gratuita. Pero el agente necesita herramientas, no URLs. Este servidor le da a cualquier cliente compatible con MCP (Claude Desktop, Cursor, Windsurf, Cline, OpenAI Codex CLI, etc.) los 10 en un solo proceso.

Related MCP server: tes-mcp-server

Instalación

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "onecall": {
      "command": "python3",
      "args": ["/path/to/onecall-mcp/src/onecall_mcp_server.py"]
    }
  }
}

Cursor

Configuración → Funciones → Model Context Protocol → Añadir nuevo servidor MCP global. Mismo command/args.

Windsurf / Cline / otros

Misma forma — command es el intérprete de Python, args es la ruta absoluta a onecall_mcp_server.py.

Verificación

# End-to-end JSON-RPC over stdio test
bash tests/mcp_stdio_smoke.sh

Última ejecución: 10/10 PASS (2026-08-26). Initialize, tools/list y tools/call devuelven JSON-RPC 2.0 correcto con datos en vivo de la API.

Arquitectura

• Solo stdlib. Sin dependencia del paquete mcp, sin requests, sin SDK. Solo urllib + json + asyncio.

• stdio JSON-RPC 2.0. Según la especificación MCP 2024-11-05.

• Reutiliza el _lib/http.py de onecall para reintentos, codificación de URL y un envoltorio uniforme.

• --demo flag imprime el catálogo de herramientas y ejecuta una llamada en vivo, útil para pruebas de cordura.

Resultados de la prueba de humo (2026-08-26)

=== Passed: 10  Failed: 0 ===

10 aserciones que cubren: handshake del protocolo, negociación de capacidades, descubrimiento de herramientas, invocación de herramientas y respuesta de API en vivo.

Hoja de ruta

• Añadir los 4 wrappers restantes de onecall (sunrise, catfact, cataas, nager holidays)

• Transporte HTTP (actualmente solo stdio)

• Registro de uso por llamada + integración de muro de pago con stablecoin x402

• Listado en glama.ai, smithery.ai, mcpmarket.com, mcpservers.org

Licencia

MIT.