Skip to content
Eden Engine

Brazilian Economic Series Metadata by Code (Ipeadata)

ipeadata/get-series-metadata

The record of one Ipeadata series by its code: name, long description, source institution and its web address, periodicity, unit, multiplier, country and last-update time. Text is in Portuguese and the description can contain HTML anchor tags. An unknown code is refused as a validation error. Find codes with ipeadata/search-series. Ipeadata (IPEA) data served by Eden Engine; not an official IPEA product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Ipeadata (IPEA)

Fonte: Ipeadata (IPEA), https://www.ipeadata.gov.br. Ipeadata publishes no licence or terms of use; the credit is a courtesy. Served by Eden Engine; not an official IPEA product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "ipeadata/get-series-metadata" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "ipeadata/get-series-metadata" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "ipeadata/get-series-metadata", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "ipeadata/get-series-metadata", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{1,40}$",
      "description": "The Ipeadata series code, letters, digits and underscore, for example PAN_TJOVER or BM12_TFPPNCN12. Use ipeadata/search-series to find one."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "SERCODIGO",
    "SERNOME"
  ],
  "properties": {
    "FNTURL": {
      "type": [
        "string",
        "null"
      ],
      "description": "Web address of the source institution."
    },
    "BASNOME": {
      "type": [
        "string",
        "null"
      ],
      "description": "The Ipeadata database (theme group) the series belongs to."
    },
    "FNTNOME": {
      "type": [
        "string",
        "null"
      ],
      "description": "Name of the source institution, in Portuguese."
    },
    "MULNOME": {
      "type": [
        "string",
        "null"
      ],
      "description": "Multiplier applied to the unit, such as milhões."
    },
    "PERNOME": {
      "type": [
        "string",
        "null"
      ],
      "description": "Periodicity in Portuguese, such as Mensal, Anual, Diária or Decenal."
    },
    "SERNOME": {
      "type": "string",
      "description": "The series name, in Portuguese."
    },
    "UNINOME": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unit of measure."
    },
    "FNTSIGLA": {
      "type": [
        "string",
        "null"
      ],
      "description": "Acronym of the source institution."
    },
    "PAICODIGO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country code of the series, such as BRA."
    },
    "SERCODIGO": {
      "type": "string",
      "description": "The series code, the key for ipeadata/series-values and ipeadata/get-series-metadata."
    },
    "SERSTATUS": {
      "type": [
        "string",
        "null"
      ],
      "description": "A when the series is active."
    },
    "TEMCODIGO": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Theme code."
    },
    "SERNUMERICA": {
      "type": "boolean",
      "description": "True when the values are numbers."
    },
    "SERCOMENTARIO": {
      "type": [
        "string",
        "null"
      ],
      "description": "Free-text description in Portuguese; it can be long and can contain HTML anchor tags."
    },
    "SERATUALIZACAO": {
      "type": [
        "string",
        "null"
      ],
      "description": "When the series was last updated, an ISO 8601 timestamp."
    }
  },
  "description": "The series record.",
  "additionalProperties": true
}