MCP server de Kyrodata
Commit 10 sept 2026Proporciona acceso al comercio brasileño, producción de cultivos, balances de oferta y demanda, lecturas climáticas y pronósticos de commodities a través de un MCP server.
También conocido como kyrodata/mcp, mcp
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.17
- Último commit
- 10 sept 2026
- Licencia
- MIT
¿Qué es Kyrodata MCP?
Proporciona acceso al comercio brasileño, producción de cultivos, balances de oferta y demanda, lecturas climáticas y pronósticos de commodities a través de un MCP server.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Kyrodata
Kyrodata ofrece un servidor remoto de Model Context Protocol diseñado para desarrolladores y analistas que realizan seguimiento de los mercados agrícolas y comerciales de Brasil. Ofrece acceso a conjuntos de datos especializados que incluyen estadísticas de comercio exterior de MDIC/ComexStat, cifras de producción de cultivos, balances de oferta y demanda, lecturas climáticas y pronósticos de commodities. Los usuarios pueden interactuar con estos datos a través de un agente de IA conectándose a un endpoint alojado mediante una API key proporcionada a través de un header de Authorization.
El servidor es compatible con varios clientes como Claude Code, Cursor, Cline y n8n. Funciona como una interfaz de solo lectura, lo que significa que puede recuperar información sin modificar ningún registro externo. Mientras que las herramientas de comercio, clima y oferta y demanda están disponibles a través de los planes estándar, las herramientas específicas de pronóstico de precios requieren una suscripción adicional. El sistema garantiza la integridad de los datos proporcionando la ventana de tiempo y la fuente específica para cada respuesta, y se negará a comparar periodos de tiempo desiguales para mantener la precisión.
Qué puedes hacer con él
- 1Analizar tendencias de exportación brasileñasCompara cifras de exportación e importación entre ventanas de tiempo específicas para diferentes commodities.
- 2Monitorear impactos climáticos agrícolasRecupera lecturas climáticas y evalúa la pérdida física de cultivos en Brasil.
- 3Evaluar balances del mercado de commoditiesAccede a balances de oferta y demanda para entender la disponibilidad del mercado.
- 4Identificar socios comerciales claveEncuentra los principales países que comercian con Brasil y observa sus tasas de crecimiento.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Kyrodata MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Kyrodata MCP en Claude Code
$ claude mcp add --transport http mcp https://mcp.kyrodata.com/mcpInstalar Kyrodata MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.kyrodata.com/mcp"
}
}
}Instalar Kyrodata MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.kyrodata.com/mcp"
}
}
}Instalar Kyrodata MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.kyrodata.com/mcp"}'Instalar Kyrodata MCP en Codex
$ codex mcp add mcp --url https://mcp.kyrodata.com/mcpInstalar Kyrodata MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.kyrodata.com/mcp"
Instalar Kyrodata MCP en Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.kyrodata.com/mcpInstalar Kyrodata MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.kyrodata.com/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblekyrodata/mcp is public and reachablegithub.com/kyrodata/mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-06github.com/kyrodata/mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 687 msAprobado
README
Ver en GitHubKyrodata
Brazilian trade, crop and commodity data over MCP
Kyrodata is a remote Model Context Protocol server. There is nothing to install or run: point your agent at the hosted endpoint and give it your API key.
https://mcp.kyrodata.com/mcp
Ask in plain language — "how did Brazil's coffee exports do this year against last?" — and get the measured figure, the window it covers, and the source behind it.
Get a key
Create one at kyrodata.com/user/api-keys. It is shown only once. Queries spend the credits already included in your plan — the connector is not a separate subscription.
Connect
Any agent that accepts a header (Cline, Claude Code, Cursor, VS Code, Codex, n8n, Zapier, Make):
{
"mcpServers": {
"kyrodata": {
"url": "https://mcp.kyrodata.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KYRODATA_API_KEY" }
}
}
}
Command-line equivalents:
claude mcp add --transport http kyrodata https://mcp.kyrodata.com/mcp \
--header "Authorization: Bearer $KYRODATA_API_KEY"
codex mcp add kyrodata --url https://mcp.kyrodata.com/mcp \
--bearer-token-env-var KYRODATA_API_KEY
gemini mcp add --transport http --header "Authorization: Bearer $KYRODATA_API_KEY" \
kyrodata https://mcp.kyrodata.com/mcp
Chat assistants (claude.ai, ChatGPT) have no field for a key — they ask for your authorization instead. Add Kyrodata as a custom connector with the same URL and sign in when prompted. Walkthrough per client: kyrodata.com/developers.
What you get
Read-only tools over Brazilian foreign trade (MDIC/ComexStat), crop production, supply and demand balances, climate readings and commodity forecasts.
| Tool | What it answers |
|---|---|
kyrodata_search |
Search the public trade catalog |
kyrodata_fetch |
Open one public trade document by id |
kyrodata_resolve_entity |
Resolve country, HS code or commodity |
kyrodata_compare_trade |
Compare exports/imports between equal windows |
kyrodata_list_trade_series |
Raw monthly trade series as rows |
kyrodata_list_trade_partners |
Top partner countries with growth |
kyrodata_get_heading_overview |
Overview of an HS heading (SH4) |
kyrodata_resolve_comparison_window |
Build a like-for-like comparison window |
kyrodata_get_supply_demand_balance |
Supply and demand balance sheet |
kyrodata_get_climate_reading |
Climate reading and physical crop loss |
kyrodata_get_hub_summary † |
Commodity hub summary and forecast verdict |
kyrodata_explain_pyramid_level † |
Explain one level of the forecast pyramid |
kyrodata_run_report |
Run one of the catalog reports |
kyrodata_get_data_coverage |
Data coverage and latest closed month |
kyrodata_get_credit_balance |
Credit balance and limits for this key (free) |
tools/list on the live endpoint is the authoritative list.
† The two price-forecast tools are part of an additional plan. Trade, climate and supply-and-demand tools are not.
How it answers
- Windows are equal-weight by construction. Three months are never compared against a full year; the server refuses the unequal window and returns the largest matching one, labeled.
- Every answer names its window and its source.
- "No signal" is a real answer where the data does not support a verdict.
- Read-only. No tool writes, deletes or buys anything.
Running it as a local command (you almost certainly should not)
bridge/server.py is a stdio-to-HTTP forwarder, and the Dockerfile packages
it. This is not the server. The server is remote, and any client that speaks
remote MCP should connect straight to the URL above — one hop fewer, nothing to
install. The bridge exists for two cases only: a client that can only launch a
local command, and a directory that will not score what it cannot build, start
and introspect.
docker build -t kyrodata-mcp .
docker run -i --rm -e KYRODATA_API_KEY=kd_live_... kyrodata-mcp
It implements no tools of its own: initialize, tools/list and tools/call
are forwarded verbatim, so there is no second copy of the catalogue here that
could drift from the server. Zero third-party dependencies, and the key never
goes into the image.
Notes
- Transport is
streamable-http. The deprecated HTTP+SSE transport is not served. - Without credentials the endpoint answers
401— never403. - Keys go in the
Authorizationheader. A key in a query string is not accepted, because query strings land in browser history and proxy logs.
MIT for this repository's contents. The hosted service has its own terms.
Preguntas sobre Kyrodata MCP
¿Cómo agrego Kyrodata MCP a Claude Code?
Ejecuta claude mcp add --transport http mcp https://mcp.kyrodata.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Kyrodata MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo me conecto a Kyrodata?
Puedes conectar cualquier agente que acepte un header apuntándolo al endpoint alojado y proporcionando tu API key en el header de Authorization.
¿El servidor permite escribir o eliminar datos?
No, el servidor es de solo lectura y no tiene herramientas para escribir, eliminar o comprar nada.
¿Necesito una suscripción aparte para el conector?
No, las consultas utilizan los créditos ya incluidos en tu plan actual de Kyrodata.
¿Las herramientas de pronóstico de precios están incluidas en todos los planes?
Las herramientas de pronóstico de precios requieren un plan adicional, mientras que las herramientas de comercio, clima y oferta y demanda están incluidas.