English Français العربية

Kyrodata — Brazil Trade, Crop & Commodity Data

Official registry Developer tools

Brazil exports/imports by HS code (ComexStat), soybean, coffee, supply-demand, climate, forecasts

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http kyrodata-brazil-trade-crop-commodity-dat 'https://mcp.kyrodata.com/mcp' --header 'Authorization: <Bearer <Kyrodata API key from kyrodata.com/user/api-keys>>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kyrodata-brazil-trade-crop-commodity-dat": {
            "type": "http",
            "url": "https://mcp.kyrodata.com/mcp",
            "headers": {
                "Authorization": "<Bearer <Kyrodata API key from kyrodata.com/user/api-keys>>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Kyrodata
  2. Get a key
  3. Connect
  4. What you get
  5. How it answers
  6. Running it as a local command (you almost certainly should not)
  7. Notes

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.

ToolWhat it answers
kyrodata_searchSearch the public trade catalog
kyrodata_fetchOpen one public trade document by id
kyrodata_resolve_entityResolve country, HS code or commodity
kyrodata_compare_tradeCompare exports/imports between equal windows
kyrodata_list_trade_seriesRaw monthly trade series as rows
kyrodata_list_trade_partnersTop partner countries with growth
kyrodata_get_heading_overviewOverview of an HS heading (SH4)
kyrodata_resolve_comparison_windowBuild a like-for-like comparison window
kyrodata_get_supply_demand_balanceSupply and demand balance sheet
kyrodata_get_climate_readingClimate 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_reportRun one of the catalog reports
kyrodata_get_data_coverageData coverage and latest closed month
kyrodata_get_credit_balanceCredit 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 — 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.

Frequently asked questions

What is Kyrodata — Brazil Trade, Crop & Commodity Data?

Brazil exports/imports by HS code (ComexStat), soybean, coffee, supply-demand, climate, forecasts

How do I install Kyrodata — Brazil Trade, Crop & Commodity Data?

It runs as a remote server. In Claude Code: claude mcp add --transport http kyrodata-brazil-trade-crop-commodity-dat 'https://mcp.kyrodata.com/mcp' --header 'Authorization: <Bearer <Kyrodata API key from kyrodata.com/user/api-keys>>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Kyrodata — Brazil Trade, Crop & Commodity Data need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Kyrodata — Brazil Trade, Crop & Commodity Data open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Kyrodata — Brazil Trade, Crop & Commodity Data?

It is published by kyrodata. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.