{"id":"com.kyrodata/kyrodata","slug":"com-kyrodata-kyrodata","title":"Kyrodata — Brazil Trade, Crop & Commodity Data","description":"Brazil exports/imports by HS code (ComexStat), soybean, coffee, supply-demand, climate, forecasts","version":"1.0.17","publisher":{"kind":"domain","id":"kyrodata.com","label":"kyrodata.com","url":"https://kyrodata.com"},"website":"https://kyrodata.com/en-US/developers","repository":"https://github.com/kyrodata/mcp","remotes":[{"type":"streamable-http","url":"https://mcp.kyrodata.com/mcp","headers":[{"description":"Bearer <Kyrodata API key from kyrodata.com/user/api-keys>","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-06","updated":"2026-10-06","status":"online","auth":"","latency_ms":3039,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"kyrodata_compare_trade","title":"Compare exports/imports between equal windows","description":"Compares Brazil's exports or imports between two equal-length windows (like-for-like), in value (USD FOB) and in volume (kg). `mode` changes the reading: quarterly, semestral, annual, ytd and rolling_3m/6m/12m look a year back and hold the season constant, while monthly and semestral_sequential compare against the period immediately before and cross one. `codes` and `countryIds` filter both window","read_only":true},{"name":"kyrodata_explain_pyramid_level","title":"Explain one level of the forecast pyramid","description":"Explains the pyramid's arithmetic for one commodity and horizon: the seven levels side by side (label, push %, weight share, confidence, contribution %) and, for the levels that did not enter, the reason with its ruler (hit rate vs base rate, number of origins). `horizon` fixes the month and shows the seven levels; `levelKey` flips the cut, following one level across all four horizons instead. Thi","read_only":true},{"name":"kyrodata_fetch","title":"Open one public trade document by id","description":"Opens ONE public foreign-trade document by id and returns it as prose to quote: title, body text and a public URL for citation. `id` is not free text — it is an id kyrodata_search returned, shaped `heading:1201` (an HS heading) or `country:160` (a partner country); anything else is refused rather than guessed. The body carries the measured figures of the latest published year, Brazilian exports an","read_only":true},{"name":"kyrodata_get_climate_reading","title":"Climate reading and physical crop loss","description":"Current climate reading for a commodity: risk level, the measured production shock in % of the harvest, and the projected physical loss in tonnes per horizon (1, 3, 6 and 12 months) with its range. `scope` sets the geographic cut — 'br' (the default) reads the country, 'region:SE' a macro-region (N, NE, CW, SE, S), 'uf:MG' a single state — and moves only the risk level and the shock: the loss in t","read_only":true},{"name":"kyrodata_get_credit_balance","title":"Credit balance and limits for this key","description":"Reports the credit balance and the limits of the API key making the request: credits left in the current cycle and when it resets, the daily credit and daily call ceilings of the key, and which tools the key reaches. `response_format` is the only input and it changes verbosity, not scope — there is no argument that selects another key, since the answer describes whichever key authenticated this ca","read_only":true},{"name":"kyrodata_get_data_coverage","title":"Data coverage and latest closed month","description":"Returns the calendar of the trade data: first and last published month (YYYYMM), whether the current year is partial, the last fully closed month, and when the aggregates were last refreshed. `response_format` is the only input; the answer covers the whole dataset, so there is no window or product to narrow it with. This answers 'até quando tem dado?' and 'qual o último mês?' — the CALENDAR, never","read_only":true},{"name":"kyrodata_get_heading_overview","title":"Overview of an HS heading (SH4)","description":"Structured read of ONE HS heading (SH4, 4 digits) for exports or imports: totals of the published year (USD FOB, kg), the last closed month against the previous one (average price per kg and volume), and a monthly price-by-volume series. `year` centres the overview and defaults to the most recent published year, with coverage starting in 2000; `months` sets only how far the series reaches back fro","read_only":true},{"name":"kyrodata_get_hub_summary","title":"Commodity hub summary and forecast verdict","description":"Reads the Kyrodata pyramid verdict for a commodity hub: direction of the leading horizon, expected move in % per horizon (1, 3, 6 and 12 months), the 80% band as a half-width in percentage points, which levels drive the verdict and the measured accuracy. A horizon without an arrow names the reason, and an empty one means no level passed the confidence gate: no signal, not a stable price. `horizon`","read_only":true},{"name":"kyrodata_get_supply_demand_balance","title":"Supply and demand balance sheet","description":"Published supply and demand balance (physical, in tonnes) for one agricultural hub, season by season: production, imports, exports, consumption, initial and final stock, whether the season is still an estimate, and how many months a partial season measures. `hub` accepts only the hubs that have a published balance sheet, which is fewer than the hubs the forecast tools cover; `closedOnly` drops the","read_only":true},{"name":"kyrodata_list_trade_partners","title":"Top partner countries with growth","description":"Ranks Brazil's partner countries for exports or imports, one row per country with value (USD FOB), volume (kg), price per kg and share of the window. `from`/`to` are YYYYMM and default to the last 12 published months; `codes` narrows to HS codes (4, 6 or 8 digits) so the ranking answers 'who buys THIS product'; `withGrowth` adds the last 12 months against the previous 12, which is the only way gro","read_only":true},{"name":"kyrodata_list_trade_series","title":"Raw monthly trade series as rows","description":"Returns Brazil's monthly export or import series as rows — one row per month, with value (USD FOB), volume (kg) and the implied price per kg. `from`/`to` are YYYYMM and default to the last 24 published months; the span is capped at 200 months and a wider one is refused rather than silently truncated. A month with nothing published is ABSENT from the series rather than present as zero, so gaps stay","read_only":true},{"name":"kyrodata_resolve_comparison_window","title":"Build a like-for-like comparison window","description":"Resolves an equal-length comparison window (like-for-like) for the trade data, anchored on the last fully published month, and returns ONLY the window metadata — from, to, label, months and whether it crosses a season. No figures. `mode` splits into two families, and the split is what matters: quarterly, semestral, annual, ytd and rolling_3m/6m/12m compare against the same period a year earlier an","read_only":true},{"name":"kyrodata_resolve_entity","title":"Resolve country, HS code or commodity","description":"Resolves a free-text name into platform identifiers for FILTERING other tools: commodity hubs (slug plus anchor SH4), HS headings (SH4), NCM codes (8 digits) and partner countries (country id). 'soja' resolves to the soybean hub and SH4 1201; 'China' to country id 160. `query` takes a name already known rather than a topic to explore, and up to 10 matches per kind come back — an ambiguous term ret","read_only":true},{"name":"kyrodata_run_report","title":"Run one of the catalog reports","description":"Runs one of the product's pre-built catalogue reports by id and returns its rows, up to 50. `reportId` is an enum of the catalogue's ids, so the whole catalogue travels in this schema and no lookup call is needed; `params` carries the values the chosen report declares, and `columnIds` narrows the projection — omitted, the report's default columns come back, and the columns that identify each row a","read_only":true},{"name":"kyrodata_search","title":"Search the public trade catalog","description":"Searches the public Brazilian foreign-trade catalogue and returns document ids for kyrodata_fetch — HS headings (SH4, 4 digits) and partner countries — each with a public URL. `query` is free text in Portuguese or a code, and both reach the same place: 'soja' and '1201' land on the soybean heading, 'China' on the partner country. This is DISCOVERY: it finds what exists when the caller has words ra","read_only":true}],"server_info":{"name":"kyrodata","title":"Kyrodata","version":"1.0.17","websiteUrl":"https://kyrodata.com/developers"},"category":"developer","tags":["open-data","analytics","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-06","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-kyrodata-kyrodata/"}