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 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_trade_compare	Exports/imports between two equal-weight windows, in USD FOB and kg
kyrodata_list_trade_partners	Top partner countries, with growth
kyrodata_get_heading_overview	Overview of an HS heading (SH4)
kyrodata_compare_periods	Builds the like-for-like window the other tools use
kyrodata_get_supply_demand_balance	Supply and demand balance sheet
kyrodata_get_climate_reading	Climate reading and physical crop loss
kyrodata_hub_summary	Commodity hub summary and forecast verdict
kyrodata_get_balance	Your remaining credits (free)

tools/list on the live endpoint is the authoritative list.

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.

Notes

• Transport is streamable-http. The deprecated HTTP+SSE transport is not served.
• Without credentials the endpoint answers 401 — never 403.
• Keys go in the Authorization header. 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.