• DATA
  • ANALYSIS
  • FORMAT
  • HUMAN

How to query BCB time series data with your AI

Connect your AI to the Central Bank of Brazil's database. Once linked, you can pull specific economic indicators using their official SGS series codes.

Ask AI about this page

Short answer

How can I get Selic or IPCA data using my AI?

Give your agent the specific SGS series code for the metric you need. It uses the get_serie_bcb tool to fetch the historical values and present them in your chat. You'll get the raw data converted into readable tables or analysis.

The results you get

What your data looks like

The AI handles the technical retrieval so you can focus on the numbers.

DATA

Instant metric retrieval

The AI uses the get_serie_bcb tool to pull specific time series from the SGS database. You get the exact historical numbers you asked for.

ANALYSIS

Automated trend spotting

Once the data is in the chat, your agent can calculate growth rates or identify shifts in inflation and interest rates.

FORMAT

Clean data presentation

The AI turns messy database responses into clean tables or lists. This makes it easy to copy the data into your own spreadsheets.

HUMAN

Manual code verification

You remain responsible for verifying that the SGS series code you provided is the correct one for your specific economic query.

The workflow

What your AI does when the request arrives.

The process moves from a simple text request to a structured data response.

  1. Identify the series

    Your agent parses your request to find the specific SGS code required for the Brazilian economic metric you want.

    get_serie_bcb
  2. Fetch the history

    The AI calls the Central Bank database to grab the historical time series associated with that code.

    get_serie_bcb
  3. Structure the results

    The agent organizes the raw time series values into a format that is easy to read or process.

    get_serie_bcb
  4. Deliver the answer

    The final data is presented in your chat interface, ready for your immediate use or further questioning.

    get_serie_bcb

Try it

Copy these to start.

Use these prompts to begin your analysis.

Starting points

Swap out the bracketed text with the actual SGS codes you find on the BCB website.

Banco Central do Brasil Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_cBPpQPYUz3LiadPILKsF9Fdzz1G8qakO7saoQNqG/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Banco Central do Brasil capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "bcb-economia-pib-divida-reservas-pix-e-sgs-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_cBPpQPYUz3LiadPILKsF9Fdzz1G8qakO7saoQNqG/mcp"
    }
  }
}
Copy into chat04
  • Get the historical data for Selic using SGS code 11.

  • Show me the IPCA series for the last 12 months using code 433.

  • Retrieve the time series for the Brazilian debt using code 187.

  • What are the recent values for the PIX transaction volume using code 35091?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect BCB Economia once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start querying the Central Bank immediately.

Connect BCB Economia to your AI

FAQ

How the connector behaves

  • 01

    Can the AI change data in the BCB database?

    No. The tool only allows for retrieving data from the SGS database. It cannot write or modify any official records.

  • 02

    Do I need to know the SGS codes?

    Yes. To get specific results, you should provide the exact SGS series code. If you don't have it, you'll need to find it on the BCB website first.

  • 03

    Can the AI download Excel files?

    No. The AI retrieves the data and displays it in your chat. You can then ask the AI to format it as a table for you to copy.

  • 04

    Does this work with any AI client?

    It works with any MCP-compatible client like Claude, Cursor, or Windsurf once you have connected the connector through Vinkius.

  • 05

    Can the AI predict future Selic rates?

    No. The tool only retrieves historical time series data. Any predictions would be the AI's own reasoning based on that history, not official BCB forecasts.

  • More questions about BCB Economia? The Connector page answers them. See everything the BCB Economia Connector can do

Connect Banco Central do Brasil to Claude, Cursor, ChatGPT & more