Skip to content

Open Economics

by felipegambettadesouza6-jpg · remote · no sign-in to list tools · v2.0.2 · published by GitHub user felipegambettadesouza6-jpg

Discover, resolve, and query official Brazilian economic data with semantic search and provenance.

Changes · 1

19 tools: 1 change things and 18 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http open-economics https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "search_official_data" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "search_official_data" says "search": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Changes things 1Claude Code: ask
  • search_official_dataStart here for a natural-language Brazilian economic-information need in Portuguese or English.1 finding

    Why it is in this group

    • The name "search_official_data" says "search": a word for reading.
    • The description's first verb is "start": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "search_official_data" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "search_official_data" says "search": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Start here for a natural-language Brazilian economic-information need in Portuguese or English. Resolves the economic concept independently of current coverage, returns ranked official datasets, stable-series shortcuts, confidence, missing source integrations, and an explicit unresolved/partial state. Use this before any data query when the exact official dataset ID is unknown.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
Only reads 18Claude Code: allow
  • describe_official_datasetGet identity, publisher, collection, provenance links, query capability, and any stable Open Economics series shortcuts for an exact dataset ID returned by search_official_data.No findings

    Why it is in this group

    • The name "describe_official_dataset" says "describe": a word for reading.
    Description, as the server wrote it
    Get identity, publisher, collection, provenance links, query capability, and any stable Open Economics series shortcuts for an exact dataset ID returned by search_official_data. This does not fetch observations.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_anp_fuel_pricesRetrieve auditable fuel and GLP price statistics calculated from official ANP station observations.No findings

    Why it is in this group

    • The name "get_anp_fuel_prices" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve auditable fuel and GLP price statistics calculated from official ANP station observations. Omit year and month for the rolling latest four weeks, or provide both for a published monthly file from 2023 onward. Results retain period, product, geography, unit, sample count, source URL, and the disclosed aggregation method while excluding station identity and addresses.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_bcb_schemaFetch authoritative metadata for an exact BCB SGS series, including full name, subject hierarchy, periodicity, unit, source, coverage dates, decimals, formula, and warnings.No findings

    Why it is in this group

    • The name "get_bcb_schema" says "get": a word for reading.
    Description, as the server wrote it
    Fetch authoritative metadata for an exact BCB SGS series, including full name, subject hierarchy, periodicity, unit, source, coverage dates, decimals, formula, and warnings. Use when interpreting a BCB series without retrieving observations.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_bcb_seriesRetrieve official observations and authoritative schema metadata for an exact BCB SGS dataset ID.No findings

    Why it is in this group

    • The name "get_bcb_series" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve official observations and authoritative schema metadata for an exact BCB SGS dataset ID. Use only after search_official_data identifies the series. Dates, units, periodicity, source, and raw values are preserved; generic access does not guess transformations.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_comexstat_dataRetrieve a bounded, explicit MDIC Comex Stat export or import slice from 1997 onward.No findings

    Why it is in this group

    • The name "get_comexstat_data" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a bounded, explicit MDIC Comex Stat export or import slice from 1997 onward. Use comexstat:general only after search_official_data. Select period, dimensions, metrics, and optional official filter codes; partner, product, state, transport, classification, and raw metric fields remain attached to the result.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_cvm_investment_fundsRetrieve daily CVM aggregates by official fund classification or resolve a fund/class latest report by CNPJ or name.No findings

    Why it is in this group

    • The name "get_cvm_investment_funds" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve daily CVM aggregates by official fund classification or resolve a fund/class latest report by CNPJ or name. Net assets and flows are additive; quota values stay fund-level; reported holder totals are not deduplicated people.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_cvm_investment_funds_schemaInspect the synchronized CVM daily-report window, official classifications, fund-search contract, measure meanings, and aggregation constraints.No findings

    Why it is in this group

    • The name "get_cvm_investment_funds_schema" says "get": a word for reading.
    Description, as the server wrote it
    Inspect the synchronized CVM daily-report window, official classifications, fund-search contract, measure meanings, and aggregation constraints. Use before querying a fund by name or comparing classes.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_epe_electricity_consumptionRetrieve monthly EPE electricity consumption and consumer counts from 2004 onward.No findings

    Why it is in this group

    • The name "get_epe_electricity_consumption" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve monthly EPE electricity consumption and consumer counts from 2004 onward. Select a bounded period, country/region/UF geography, consumption classes, and regulated/free market. The response identifies the exact synchronized official workbook version and discloses aggregation across source system rows.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_ibge_dataRetrieve an explicit slice of an IBGE aggregate after inspecting its schema.No findings

    Why it is in this group

    • The name "get_ibge_data" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve an explicit slice of an IBGE aggregate after inspecting its schema. Returns variables containing classification selections, geographies, and observations; official suppression, missing, quality-flag, and zero states remain distinct.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_ibge_schemaFetch official metadata for an IBGE aggregate selected by search_official_data.No findings

    Why it is in this group

    • The name "get_ibge_schema" says "get": a word for reading.
    Description, as the server wrote it
    Fetch official metadata for an IBGE aggregate selected by search_official_data. Always use this before get_ibge_data unless the official variable, locality, and classification IDs are already known. It prevents guessing a measure or dimensional slice.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_mte_formal_employmentRetrieve revised monthly Novo Caged stock, admissions, dismissals, balance, and relative change from 2020 onward.No findings

    Why it is in this group

    • The name "get_mte_formal_employment" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve revised monthly Novo Caged stock, admissions, dismissals, balance, and relative change from 2020 onward. Select exactly one official breakdown: country, region, state, or economic activity. The response preserves the MTE workbook vintage and never synthesizes state-by-industry values.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_mte_formal_employment_schemaInspect the official adjusted Novo Caged selection contract, source vintage, measure meanings, available industry IDs, and the constraint that geography and industry come from sepa…No findings

    Why it is in this group

    • The name "get_mte_formal_employment_schema" says "get": a word for reading.
    Description, as the server wrote it
    Inspect the official adjusted Novo Caged selection contract, source vintage, measure meanings, available industry IDs, and the constraint that geography and industry come from separate official tables. Use before an industry query.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_siconfi_dataRetrieve an explicit official SICONFI DCA, RREO, RGF, or entity-registry selection.No findings

    Why it is in this group

    • The name "get_siconfi_data" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve an explicit official SICONFI DCA, RREO, RGF, or entity-registry selection. First inspect the schema. This tool preserves account, column, annex, period, entity, raw value fields, and upstream provenance without aggregating or substituting concepts.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • get_siconfi_schemaGet the meaning and required selection fields for an exact SICONFI dataset returned by search_official_data.No findings

    Why it is in this group

    • The name "get_siconfi_schema" says "get": a word for reading.
    Description, as the server wrote it
    Get the meaning and required selection fields for an exact SICONFI dataset returned by search_official_data. Use this before get_siconfi_data so entity, reporting period, report type, government branch, and annex are explicit rather than guessed.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_tesouro_dpfRetrieve one official monthly RMD table at a time: debt composition, DPMFi holders, average maturity, average maturity by indexer, monthly cost, or twelve-month cost.No findings

    Why it is in this group

    • The name "get_tesouro_dpf" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve one official monthly RMD table at a time: debt composition, DPMFi holders, average maturity, average maturity by indexer, monthly cost, or twelve-month cost. Units remain table-specific and are never combined.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_tesouro_dpf_schemaInspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting…No findings

    Why it is in this group

    • The name "get_tesouro_dpf_schema" says "get": a word for reading.
    Description, as the server wrote it
    Inspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting data.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_tesouro_rtnRetrieve monthly current-value RTN accounts from 1997 onward.No findings

    Why it is in this group

    • The name "get_tesouro_rtn" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve monthly current-value RTN accounts from 1997 onward. Defaults to total revenue, transfers, net revenue, total expenditure, and the above-the-line primary result; select exact account IDs or search account labels for detail.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_tesouro_rtn_schemaInspect RTN table 1.2 account IDs, hierarchy, current-value unit, coverage, source vintage, and above/below-the-line constraints.No findings

    Why it is in this group

    • The name "get_tesouro_rtn_schema" says "get": a word for reading.
    Description, as the server wrote it
    Inspect RTN table 1.2 account IDs, hierarchy, current-value unit, coverage, source vintage, and above/below-the-line constraints. Use before selecting revenue or expenditure categories.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 2.0.2. Values in angle brackets are yours to fill in.

claude mcp add --transport http open-economics https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__open-economics__describe_official_dataset",
      "mcp__open-economics__get_bcb_series",
      "mcp__open-economics__get_bcb_schema",
      "mcp__open-economics__get_ibge_schema",
      "mcp__open-economics__get_ibge_data",
      "mcp__open-economics__get_siconfi_schema",
      "mcp__open-economics__get_siconfi_data",
      "mcp__open-economics__get_comexstat_data",
      "mcp__open-economics__get_anp_fuel_prices",
      "mcp__open-economics__get_epe_electricity_consumption",
      "mcp__open-economics__get_mte_formal_employment_schema",
      "mcp__open-economics__get_mte_formal_employment",
      "mcp__open-economics__get_cvm_investment_funds_schema",
      "mcp__open-economics__get_tesouro_rtn_schema",
      "mcp__open-economics__get_tesouro_rtn",
      "mcp__open-economics__get_tesouro_dpf_schema",
      "mcp__open-economics__get_tesouro_dpf",
      "mcp__open-economics__get_cvm_investment_funds"
    ],
    "ask": [
      "mcp__open-economics__search_official_data"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as open-economics. Review it before you use it.