Kyrodata — 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 ityour 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 shownonly once. Queries spend the credits already included in your plan — the connector is not aseparate 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 yourauthorization instead. Add Kyrodata as a custom connector with the same URL and sign in whenprompted. Walkthrough per client: kyrodata.com/developers.
What you get
Read-only tools over Brazilian foreign trade (MDIC/ComexStat), crop production, supply anddemand 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_partners |
Top partner countries with growth |
kyrodata_get_heading_overview |
Overview of an HS heading (SH4) |
kyrodata_compare_periods |
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_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 andsupply-and-demand tools are not.
How it answers
- Windows are equal-weight by construction. Three months are never compared against afull 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.
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, becausequery strings land in browser history and proxy logs.
MIT for this repository's contents. The hosted service has its ownterms.