Koskamo

Open Economics MCP

A free, public, read-only API and MCP server providing access to official Brazilian economic and financial data. It supports semantic search, dataset inspection, and querying of indicators from sources like IBGE, BCB, and CVM, preserving provenance and units without fabrication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Open Economics MCP logo, by Open EconomicsCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Open Economics
MCP endpoint (Streamable HTTP)
https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp
Vendor documentation

What its tools do

19 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (19)

19 of 19 have a description · 19 of 19 declare behavior hints · 19 of 19 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Resolve natural-language economic queries
  • Query official datasets like IPCA or Selic
  • Inspect dataset schemas and metadata
  • Fetch historical economic indicator values

Source and maintenance

Community listingRegistry 2.0.2
mcp-registry: io.github.felipegambettadesouza6-jpg/open-economics@2.0.2Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
open-economics 2.0.2
MCP protocol negotiated in check
2025-11-25
Tools
19 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Resolve the user's economic need with search_official_data before selecting data. Never substitute a nearby series for an unsupported need. Preserve units, reference periods, dimensions, source identifiers, source URLs, and retrieval times in answers.

Tools

19 advertised

search_official_data — Search Brazilian official economic data
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

search_official_data input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum official dataset candidates to return."
    },
    "query": {
      "type": "string",
      "maxLength": 300,
      "minLength": 2,
      "description": "The user's complete economic-data need, including measure, geography, period, and breakdown when known."
    }
  }
}
search_official_data output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query",
    "normalizedQuery",
    "resolution",
    "concepts",
    "datasets",
    "availability"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The original natural-language economic need."
    },
    "concepts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable Open Economics concept ID."
          }
        },
        "additionalProperties": {}
      },
      "description": "Ranked economic concepts matched to the request."
    },
    "datasets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "provider",
          "sourceAgency",
          "title",
          "sourceUrl",
          "metadataUrl"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable official dataset ID."
          },
          "title": {
            "type": "string",
            "description": "Official dataset title."
          },
          "provider": {
            "type": "string",
            "description": "Open Economics provider identifier."
          },
          "sourceUrl": {
            "type": "string",
            "description": "Official source URL."
          },
          "metadataUrl": {
            "type": "string",
            "description": "Official metadata URL."
          },
          "sourceAgency": {
            "type": "string",
            "description": "Official publishing agency."
          }
        },
        "additionalProperties": {}
      },
      "description": "Ranked official datasets and their source identity."
    },
    "resolution": {
      "type": "object",
      "required": [
        "status",
        "explanation"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "Resolution state for the requested concept."
        },
        "confidence": {
          "type": "number",
          "description": "Resolution confidence from 0 to 1."
        },
        "explanation": {
          "type": "string",
          "description": "Why the concept was or was not resolved."
        }
      },
      "description": "Concept-resolution result.",
      "additionalProperties": {}
    },
    "availability": {
      "type": "object",
      "required": [
        "status",
        "complete",
        "explanation",
        "missingSources"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "Availability state in the current Open Economics coverage."
        },
        "complete": {
          "type": "boolean",
          "description": "Whether the requested need is completely covered."
        },
        "explanation": {
          "type": "string",
          "description": "Coverage explanation."
        },
        "missingSources": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Required source integrations that are not present."
        }
      },
      "description": "Coverage assessment.",
      "additionalProperties": {}
    },
    "normalizedQuery": {
      "type": "string",
      "description": "Normalized form used for semantic resolution."
    }
  },
  "description": "Semantic discovery result with ranked concepts, official datasets, and coverage state.",
  "additionalProperties": {}
}
search_official_data annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
describe_official_dataset — Describe an official dataset
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

describe_official_dataset input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^(?:(?:bcb-sgs|ibge-aggregates):\\d+|siconfi:(?:rreo|rgf|dca|entes)|tesouro-rtn:government-central|tesouro-dpf:debt-profile|comexstat:general|anp:fuel-prices|epe:electricity-consumption|mte:formal-employment|cvm:investment-funds)$",
      "description": "Exact ID returned by search_official_data, such as bcb-sgs:432, ibge-aggregates:5932, siconfi:dca, tesouro-rtn:government-central, tesouro-dpf:debt-profile, comexstat:general, anp:fuel-prices, epe:electricity-consumption, mte:formal-employment, or cvm:investment-funds."
    }
  }
}
describe_official_dataset output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "provider",
    "sourceAgency",
    "title",
    "sourceUrl",
    "metadataUrl",
    "queryCapability"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable official dataset ID."
    },
    "title": {
      "type": "string",
      "description": "Official dataset title."
    },
    "provider": {
      "type": "string",
      "description": "Open Economics provider identifier."
    },
    "sourceUrl": {
      "type": "string",
      "description": "Official source URL."
    },
    "collection": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Official collection identifier, when supplied by the publisher."
    },
    "metadataUrl": {
      "type": "string",
      "description": "Official metadata URL."
    },
    "sourceAgency": {
      "type": "string",
      "description": "Official publishing agency."
    },
    "collectionName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Official collection name, when supplied by the publisher."
    },
    "queryCapability": {
      "type": "string",
      "description": "Supported query capability."
    }
  },
  "description": "Official dataset identity, source, provenance, and query capability.",
  "additionalProperties": {}
}
describe_official_dataset annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_bcb_series — Get observations from a BCB SGS series
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_bcb_series input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end date; defaults to today."
    },
    "limit": {
      "type": "integer",
      "default": 5000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum number of observations to return."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "asc",
      "description": "Observation order by date."
    },
    "start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start date; defaults to three years ago."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^bcb-sgs:\\d+$",
      "description": "Exact BCB dataset ID returned by search_official_data."
    }
  }
}
get_bcb_series output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_bcb_series annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_bcb_schema — Inspect BCB series meaning and units
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_bcb_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^bcb-sgs:\\d+$",
      "description": "Exact BCB dataset ID returned by search_official_data."
    }
  }
}
get_bcb_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_bcb_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_ibge_schema — Inspect an IBGE aggregate's measures and dimensions
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_ibge_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^ibge-aggregates:\\d+$",
      "description": "Exact IBGE aggregate ID returned by search_official_data."
    }
  }
}
get_ibge_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_ibge_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_ibge_data — Query multidimensional IBGE data
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_ibge_data input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "variable"
  ],
  "properties": {
    "periods": {
      "type": "string",
      "default": "-12",
      "pattern": "^(?:-\\d{1,3}|\\d{4,6}(?:\\|\\d{4,6}){0,119})$",
      "description": "Recent-period shorthand such as -12, or explicit official period IDs separated by |."
    },
    "locality": {
      "type": "string",
      "default": "BR",
      "pattern": "^(?:BR|N\\d{1,2}\\[(?:all|\\d+(?:,\\d+)*)\\])$",
      "description": "BR or an explicit IBGE geography selection such as N3[35]."
    },
    "variable": {
      "type": "string",
      "pattern": "^\\d+(?:\\|\\d+)*$",
      "description": "One or more official variable IDs separated by |."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^ibge-aggregates:\\d+$",
      "description": "Exact IBGE aggregate ID returned by search_official_data."
    },
    "classification": {
      "type": "string",
      "pattern": "^\\d+\\[(?:all|\\d+(?:,\\d+)*)\\](?:\\|\\d+\\[(?:all|\\d+(?:,\\d+)*)\\])*$",
      "description": "Explicit classification selections from the schema, such as 11255[90707]."
    }
  }
}
get_ibge_data output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_ibge_data annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_siconfi_schema — Inspect a SICONFI fiscal report
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_siconfi_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^siconfi:(?:rreo|rgf|dca|entes)$",
      "description": "Exact SICONFI dataset ID returned by search_official_data."
    }
  }
}
get_siconfi_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_siconfi_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_siconfi_data — Query official SICONFI fiscal data
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_siconfi_data input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2013,
      "description": "Calendar year of the official report."
    },
    "annex": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Exact official annex name from the SICONFI documentation."
    },
    "power": {
      "enum": [
        "E",
        "L",
        "J",
        "M",
        "D"
      ],
      "type": "string",
      "description": "RGF government branch."
    },
    "entity": {
      "type": "integer",
      "maximum": 9999999,
      "minimum": 1,
      "description": "Official IBGE entity code."
    },
    "period": {
      "type": "integer",
      "maximum": 6,
      "minimum": 1,
      "description": "RREO bimestre (1-6) or RGF period (1-3)."
    },
    "sphere": {
      "enum": [
        "M",
        "E",
        "U",
        "C"
      ],
      "type": "string",
      "description": "Government sphere: municipal, state, federal, or consortium."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^siconfi:(?:rreo|rgf|dca|entes)$",
      "description": "Exact SICONFI dataset ID returned by search_official_data."
    },
    "periodicity": {
      "enum": [
        "Q",
        "S"
      ],
      "type": "string",
      "description": "RGF only: four-month (Q) or half-year (S)."
    },
    "report_type": {
      "enum": [
        "RREO",
        "RREO Simplificado",
        "RGF",
        "RGF Simplificado"
      ],
      "type": "string",
      "description": "Official SICONFI report type for the selected dataset."
    }
  }
}
get_siconfi_data output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_siconfi_data annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_comexstat_data — Query official Brazilian merchandise trade
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_comexstat_data input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "flow",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Last month, YYYY-MM."
    },
    "flow": {
      "enum": [
        "export",
        "import"
      ],
      "type": "string",
      "description": "Trade direction to retrieve."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "First month, YYYY-MM."
    },
    "details": {
      "type": "array",
      "items": {
        "enum": [
          "country",
          "economicBlock",
          "state",
          "via",
          "urf",
          "ncm",
          "subHeading",
          "heading",
          "chapter",
          "section",
          "BECLevel3",
          "BECLevel2",
          "BECLevel1",
          "SITCBasicHeading",
          "SITCSubGroup",
          "SITCGroup",
          "SITCDivision",
          "SITCSection",
          "ISICClass",
          "ISICGroup",
          "ISICDivision",
          "ISICSection"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 8,
      "description": "Official dimensions to include, up to eight."
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "filter",
          "values"
        ],
        "properties": {
          "filter": {
            "enum": [
              "country",
              "economicBlock",
              "state",
              "via",
              "urf",
              "ncm",
              "subHeading",
              "heading",
              "chapter",
              "section",
              "BECLevel3",
              "BECLevel2",
              "BECLevel1",
              "SITCBasicHeading",
              "SITCSubGroup",
              "SITCGroup",
              "SITCDivision",
              "SITCSection",
              "ISICClass",
              "ISICGroup",
              "ISICDivision",
              "ISICSection"
            ],
            "type": "string",
            "description": "Official dimension code to filter."
          },
          "values": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 30
                },
                {
                  "type": "number"
                }
              ]
            },
            "maxItems": 50,
            "minItems": 1,
            "description": "One or more official filter values."
          }
        }
      },
      "default": [],
      "maxItems": 6,
      "description": "Optional official dimension filters."
    },
    "metrics": {
      "type": "array",
      "items": {
        "enum": [
          "metricFOB",
          "metricKG",
          "metricStatistic",
          "metricFreight",
          "metricInsurance",
          "metricCIF"
        ],
        "type": "string"
      },
      "default": [
        "metricFOB"
      ],
      "maxItems": 6,
      "description": "Official Comex Stat metrics to return."
    },
    "language": {
      "enum": [
        "pt",
        "en",
        "es"
      ],
      "type": "string",
      "default": "pt",
      "description": "Language for labels in the upstream response."
    },
    "dataset_id": {
      "type": "string",
      "const": "comexstat:general",
      "description": "The official MDIC Comex Stat dataset identifier."
    },
    "month_detail": {
      "type": "boolean",
      "default": true,
      "description": "Whether to keep month-level detail in the response."
    }
  }
}
get_comexstat_data output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_comexstat_data annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_anp_fuel_prices — Query official ANP fuel prices
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_anp_fuel_prices input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "fuel_group"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2023,
      "description": "Published source year; provide with month for a monthly file."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum aggregate rows to return."
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Published source month; provide with year for a monthly file."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter Brazilian state code when geography is state or municipality."
    },
    "period": {
      "enum": [
        "week",
        "month"
      ],
      "type": "string",
      "default": "week",
      "description": "Reporting period granularity."
    },
    "product": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Exact ANP product label, for example GASOLINA or ETANOL."
    },
    "geography": {
      "enum": [
        "country",
        "region",
        "state",
        "municipality"
      ],
      "type": "string",
      "default": "country",
      "description": "Geographic aggregation level."
    },
    "dataset_id": {
      "type": "string",
      "const": "anp:fuel-prices",
      "description": "The official ANP fuel-prices dataset identifier."
    },
    "fuel_group": {
      "enum": [
        "gasoline-ethanol",
        "diesel-gnv",
        "glp"
      ],
      "type": "string",
      "description": "ANP product group to retrieve."
    },
    "municipality": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Municipality name when geography is municipality."
    }
  }
}
get_anp_fuel_prices output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_anp_fuel_prices annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_epe_electricity_consumption — Query official electricity consumption
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_epe_electricity_consumption input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "states": {
      "type": "array",
      "items": {
        "enum": [
          "AC",
          "AL",
          "AM",
          "AP",
          "BA",
          "CE",
          "DF",
          "ES",
          "GO",
          "MA",
          "MG",
          "MS",
          "MT",
          "PA",
          "PB",
          "PE",
          "PI",
          "PR",
          "RJ",
          "RN",
          "RO",
          "RR",
          "RS",
          "SC",
          "SE",
          "SP",
          "TO"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 8,
      "description": "Optional official state codes when geography is state."
    },
    "classes": {
      "type": "array",
      "items": {
        "enum": [
          "Comercial",
          "Industrial",
          "Outros",
          "Residencial",
          "Rural"
        ],
        "type": "string"
      },
      "default": [
        "Comercial",
        "Industrial",
        "Outros",
        "Residencial",
        "Rural"
      ],
      "maxItems": 5,
      "description": "Consumption classes to include."
    },
    "markets": {
      "type": "array",
      "items": {
        "enum": [
          "Cativo",
          "Livre"
        ],
        "type": "string"
      },
      "default": [
        "Cativo",
        "Livre"
      ],
      "maxItems": 2,
      "description": "Electricity-market segments to include."
    },
    "regions": {
      "type": "array",
      "items": {
        "enum": [
          "Centro-Oeste",
          "Nordeste",
          "Norte",
          "Sudeste",
          "Sul"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 5,
      "description": "Optional official regions when geography is region."
    },
    "geography": {
      "enum": [
        "country",
        "region",
        "state"
      ],
      "type": "string",
      "default": "country",
      "description": "Geographic aggregation level."
    },
    "dataset_id": {
      "type": "string",
      "const": "epe:electricity-consumption",
      "description": "The official EPE electricity-consumption dataset identifier."
    }
  }
}
get_epe_electricity_consumption output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_epe_electricity_consumption annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_mte_formal_employment_schema — Inspect Novo Caged dimensions and measures
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_mte_formal_employment_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "mte:formal-employment",
      "description": "The official MTE Novo Caged dataset identifier."
    }
  }
}
get_mte_formal_employment_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_mte_formal_employment_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_mte_formal_employment — Query official formal-employment stock and flows
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_mte_formal_employment input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "states": {
      "type": "array",
      "items": {
        "enum": [
          "AC",
          "AL",
          "AM",
          "AP",
          "BA",
          "CE",
          "DF",
          "ES",
          "GO",
          "MA",
          "MG",
          "MS",
          "MT",
          "PA",
          "PB",
          "PE",
          "PI",
          "PR",
          "RJ",
          "RN",
          "RO",
          "RR",
          "RS",
          "SC",
          "SE",
          "SP",
          "TO"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 27,
      "description": "Optional official state codes when breakdown is state."
    },
    "regions": {
      "type": "array",
      "items": {
        "enum": [
          "Centro-Oeste",
          "Nordeste",
          "Norte",
          "Sudeste",
          "Sul"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 5,
      "description": "Optional official regions when breakdown is region."
    },
    "breakdown": {
      "enum": [
        "country",
        "region",
        "state",
        "industry"
      ],
      "type": "string",
      "default": "country",
      "description": "Official breakdown for the employment result."
    },
    "dataset_id": {
      "type": "string",
      "const": "mte:formal-employment",
      "description": "The official MTE Novo Caged dataset identifier."
    },
    "industries": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      },
      "default": [],
      "maxItems": 26,
      "description": "Exact official activity IDs returned by get_mte_formal_employment_schema; empty means all activities."
    }
  }
}
get_mte_formal_employment output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_mte_formal_employment annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_cvm_investment_funds_schema — Inspect CVM investment-fund measures and dimensions
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_cvm_investment_funds_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "cvm:investment-funds",
      "description": "The official CVM investment-funds dataset identifier."
    }
  }
}
get_cvm_investment_funds_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_cvm_investment_funds_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_tesouro_rtn_schema — Inspect Government Central fiscal accounts
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_tesouro_rtn_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "tesouro-rtn:government-central",
      "description": "The official Tesouro Nacional RTN dataset identifier."
    }
  }
}
get_tesouro_rtn_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_tesouro_rtn_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_tesouro_rtn — Query Government Central revenue, expenditure, and result
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_tesouro_rtn input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum account rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Account-label search; omit accounts to search the full tree."
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d+(?:\\.\\d+)*$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Exact account IDs returned by get_tesouro_rtn_schema."
    },
    "dataset_id": {
      "type": "string",
      "const": "tesouro-rtn:government-central",
      "description": "The official Tesouro Nacional RTN dataset identifier."
    }
  }
}
get_tesouro_rtn output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_tesouro_rtn annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_tesouro_dpf_schema — Inspect Federal Public Debt statistics
Advertised by the server during the last successful anonymous check.
Advertised read-only

Inspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting data.

get_tesouro_dpf_schema input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "tesouro-dpf:debt-profile",
      "description": "The official Tesouro Nacional DPF debt-profile dataset identifier."
    }
  }
}
get_tesouro_dpf_schema output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_tesouro_dpf_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_tesouro_dpf — Query Federal Public Debt statistics
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_tesouro_dpf input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum debt-statistics rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Category-label search; useful when category IDs are unknown."
    },
    "table": {
      "enum": [
        "composition",
        "holders",
        "average-maturity",
        "average-maturity-by-indexer",
        "monthly-cost",
        "twelve-month-cost"
      ],
      "type": "string",
      "default": "composition",
      "description": "Versioned RMD table to retrieve."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Exact category IDs returned for the selected table by get_tesouro_dpf_schema."
    },
    "dataset_id": {
      "type": "string",
      "const": "tesouro-dpf:debt-profile",
      "description": "The official Tesouro Nacional DPF debt-profile dataset identifier."
    }
  }
}
get_tesouro_dpf output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_tesouro_dpf annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_cvm_investment_funds — Query official CVM investment-fund reports
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_cvm_investment_funds input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive last report date, YYYY-MM-DD."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive first report date, YYYY-MM-DD."
    },
    "funds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{14}$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Unformatted 14-digit fund/class CNPJ values."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum fund or classification rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Fund-name search; use only with breakdown=fund."
    },
    "breakdown": {
      "enum": [
        "classification",
        "fund"
      ],
      "type": "string",
      "default": "classification",
      "description": "Whether to aggregate by official classification or resolve a fund."
    },
    "dataset_id": {
      "type": "string",
      "const": "cvm:investment-funds",
      "description": "The official CVM investment-funds dataset identifier."
    },
    "classifications": {
      "type": "array",
      "items": {
        "enum": [
          "Ações",
          "Cambial",
          "FMP-FGTS",
          "Multimercado",
          "Não classificado",
          "Renda Fixa"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 6,
      "description": "Official fund classifications to include."
    }
  }
}
get_cvm_investment_funds output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "description": "Source-preserving data or schema payload for the selected official dataset."
    },
    "meta": {
      "type": "object",
      "properties": {
        "dataset": {
          "description": "Open Economics dataset identity when supplied."
        },
        "provenance": {
          "description": "Upstream source URLs, versions, timestamps, and methodology details."
        }
      },
      "description": "Response metadata and source provenance.",
      "additionalProperties": {}
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string",
          "description": "Canonical URL for this response."
        },
        "observations": {
          "type": "string",
          "description": "Canonical observations endpoint for this dataset."
        }
      },
      "description": "Related API links.",
      "additionalProperties": {}
    }
  },
  "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.",
  "additionalProperties": {}
}
get_cvm_investment_funds annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
2840 ms
95th percentile latency
2840 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 2840 ms · metadata changed · 19 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http open-economics-mcp https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add open-economics-mcp --url https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable open-economics-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "open-economics-mcp": {
      "url": "https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "open-economics-mcp": {
      "type": "streamableHttp",
      "url": "https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start open-economics-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "open-economics-mcp": {
      "type": "http",
      "url": "https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http open-economics-mcp https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "open-economics-mcp": {
      "serverUrl": "https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Open Economics MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,257