bcb-br-mcp 1.1.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/README.md +256 -228
  2. package/README.pt-BR.md +388 -0
  3. package/dist/index.js +89 -786
  4. package/dist/index.js.map +1 -1
  5. package/dist/tools.d.ts +280 -0
  6. package/dist/tools.d.ts.map +1 -0
  7. package/dist/tools.js +725 -0
  8. package/dist/tools.js.map +1 -0
  9. package/dist/worker.d.ts +20 -0
  10. package/dist/worker.d.ts.map +1 -0
  11. package/dist/worker.js +236 -0
  12. package/dist/worker.js.map +1 -0
  13. package/package.json +20 -8
package/README.md CHANGED
@@ -1,49 +1,64 @@
1
1
  # BCB BR MCP Server
2
2
 
3
3
  [![npm version](https://badge.fury.io/js/bcb-br-mcp.svg)](https://www.npmjs.com/package/bcb-br-mcp)
4
+ [![npm downloads](https://img.shields.io/npm/dm/bcb-br-mcp.svg)](https://www.npmjs.com/package/bcb-br-mcp)
5
+ [![Smithery](https://img.shields.io/badge/Smithery-bcb--br--mcp-orange)](https://smithery.ai/server/@sidneybissoli/bcb-br-mcp)
4
6
  [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
7
+ [![LobeHub](https://lobehub.com/badge/mcp/sidneybissoli-bcb-br-mcp)](https://lobehub.com/mcp/sidneybissoli-bcb-br-mcp)
5
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
9
 
7
- Servidor MCP (Model Context Protocol) para acesso às séries temporais do Banco Central do Brasil (SGS/BCB).
10
+ [Leia em Português](README.pt-BR.md)
8
11
 
9
- Permite consultar indicadores econômicos e financeiros como **Selic**, **IPCA**, **câmbio**, **PIB**, entre outros, diretamente em assistentes de IA como Claude.
12
+ MCP (Model Context Protocol) server for accessing the Brazilian Central Bank's time series data (SGS/BCB).
10
13
 
11
- ## Funcionalidades
14
+ Query economic and financial indicators such as **Selic** (interest rate), **IPCA** (inflation), **exchange rates**, **GDP**, and more, directly from AI assistants like Claude.
12
15
 
13
- - **Consulta de séries históricas** - Busca valores de séries por código com filtro de datas
14
- - **Últimos valores** - Obtém os N valores mais recentes de uma série
15
- - **Metadados** - Informações detalhadas sobre séries (periodicidade, fonte, etc.)
16
- - **Catálogo de séries populares** - Lista de 150+ indicadores econômicos organizados em 12 categorias
17
- - **Busca inteligente** - Encontra séries por termo de busca (com ou sem acentos)
18
- - **Indicadores atuais** - Valores mais recentes dos principais indicadores econômicos
19
- - **Cálculo de variação** - Variação percentual entre períodos com estatísticas
20
- - **Comparação de séries** - Compara múltiplas séries no mesmo período
16
+ ## Features
21
17
 
22
- ## Ferramentas Disponíveis
18
+ - **Historical data** - Query time series values by code with date filters
19
+ - **Latest values** - Get the most recent N values of any series
20
+ - **Metadata** - Detailed information about series (frequency, source, etc.)
21
+ - **Popular series catalog** - 150+ economic indicators organized in 12 categories
22
+ - **Smart search** - Find series by keyword (accent-insensitive)
23
+ - **Current indicators** - Latest values for key economic indicators
24
+ - **Variation calculation** - Percentage change between periods with statistics
25
+ - **Series comparison** - Compare multiple series over the same period
23
26
 
24
- | Ferramenta | Descrição |
25
- |------------|-----------|
26
- | `bcb_serie_valores` | Consulta valores de uma série por código e período |
27
- | `bcb_serie_ultimos` | Obtém os últimos N valores de uma série |
28
- | `bcb_serie_metadados` | Retorna informações/metadados de uma série |
29
- | `bcb_series_populares` | Lista séries populares agrupadas por categoria |
30
- | `bcb_buscar_serie` | Busca séries por nome ou descrição (aceita termos sem acento) |
31
- | `bcb_indicadores_atuais` | Valores mais recentes: Selic, IPCA, Dólar, IBC-Br |
32
- | `bcb_variacao` | Calcula variação percentual entre duas datas ou últimos N períodos |
33
- | `bcb_comparar` | Compara 2 a 5 séries no mesmo período com ranking |
27
+ ## Available Tools
34
28
 
35
- ## Instalação
29
+ | Tool | Description |
30
+ |------|-------------|
31
+ | `bcb_serie_valores` | Query series values by code and date range |
32
+ | `bcb_serie_ultimos` | Get the last N values of a series |
33
+ | `bcb_serie_metadados` | Get series metadata (name, frequency, source) |
34
+ | `bcb_series_populares` | List popular series grouped by category |
35
+ | `bcb_buscar_serie` | Search series by name or description (accent-insensitive) |
36
+ | `bcb_indicadores_atuais` | Latest values: Selic, IPCA, USD/BRL, IBC-Br |
37
+ | `bcb_variacao` | Calculate percentage variation between dates or last N periods |
38
+ | `bcb_comparar` | Compare 2 to 5 series over the same period with ranking |
36
39
 
37
- ### Claude Desktop
40
+ ## Installation
38
41
 
39
- Adicione ao arquivo de configuração do Claude Desktop:
42
+ ### Via Smithery (recommended)
43
+
44
+ Visit [bcb-br-mcp on Smithery](https://smithery.ai/server/@sidneybissoli/bcb-br-mcp) and follow the installation instructions for your MCP client.
45
+
46
+ ### Via URL (Claude.ai, Claude Desktop, any MCP client)
47
+
48
+ Use the HTTP endpoint directly, no installation required:
49
+
50
+ ```
51
+ https://bcb.sidneybissoli.workers.dev
52
+ ```
53
+
54
+ ### Via npx (Claude Desktop)
55
+
56
+ Add to your Claude Desktop configuration file:
40
57
 
41
58
  **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
42
59
 
43
60
  **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
44
61
 
45
- #### Opção 1: Via npx (recomendado)
46
-
47
62
  ```json
48
63
  {
49
64
  "mcpServers": {
@@ -55,7 +70,7 @@ Adicione ao arquivo de configuração do Claude Desktop:
55
70
  }
56
71
  ```
57
72
 
58
- #### Opção 2: Instalação global
73
+ ### Via global install
59
74
 
60
75
  ```bash
61
76
  npm install -g bcb-br-mcp
@@ -71,216 +86,216 @@ npm install -g bcb-br-mcp
71
86
  }
72
87
  ```
73
88
 
74
- ## Exemplos de Uso
89
+ ## Usage Examples
75
90
 
76
- ### Consultar a Selic atual
91
+ ### Get the current Selic rate
77
92
 
78
93
  ```
79
- Qual a taxa Selic atual?
80
- → Usa bcb_indicadores_atuais
94
+ What is the current Selic interest rate?
95
+ → Uses bcb_indicadores_atuais
81
96
  ```
82
97
 
83
- ### Histórico do IPCA em 2024
98
+ ### IPCA history for 2024
84
99
 
85
100
  ```
86
- Mostre o IPCA mensal de 2024
87
- → Usa bcb_serie_valores com código 433, dataInicial 2024-01-01, dataFinal 2024-12-31
101
+ Show me the monthly IPCA for 2024
102
+ → Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31
88
103
  ```
89
104
 
90
- ### Listar indicadores de inflação
105
+ ### List inflation indicators
91
106
 
92
107
  ```
93
- Quais séries de inflação estão disponíveis?
94
- → Usa bcb_series_populares com categoria "Inflação"
108
+ What inflation series are available?
109
+ → Uses bcb_series_populares with category "Inflação"
95
110
  ```
96
111
 
97
- ### Buscar séries sobre dólar
112
+ ### Search for USD exchange rate series
98
113
 
99
114
  ```
100
- Busque séries relacionadas ao dólar
101
- → Usa bcb_buscar_serie com termo "dolar" (funciona mesmo sem acento)
115
+ Search for series related to the dollar
116
+ → Uses bcb_buscar_serie with term "dolar" (works without accents)
102
117
  ```
103
118
 
104
- ### Calcular variação do dólar
119
+ ### Calculate USD/BRL variation
105
120
 
106
121
  ```
107
- Qual foi a variação do dólar nos últimos 12 meses?
108
- → Usa bcb_variacao com código 1 e periodos 12
122
+ What was the USD/BRL variation over the last 12 months?
123
+ → Uses bcb_variacao with code 1 and periodos 12
109
124
  ```
110
125
 
111
- ### Comparar IPCA, IGP-M e INPC
126
+ ### Compare IPCA, IGP-M, and INPC
112
127
 
113
128
  ```
114
- Compare IPCA, IGP-M e INPC em 2024
115
- → Usa bcb_comparar com códigos [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31
129
+ Compare IPCA, IGP-M, and INPC in 2024
130
+ → Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31
116
131
  ```
117
132
 
118
- ## Catálogo de Séries (150+)
119
-
120
- O servidor inclui um catálogo com mais de 150 séries organizadas em 12 categorias.
121
-
122
- ### Juros e Taxas
123
-
124
- | Código | Descrição |
125
- |--------|-----------|
126
- | 11 | Taxa Selic acumulada no mês |
127
- | 432 | Taxa Selic anualizada base 252 |
128
- | 1178 | Taxa Selic - Meta definida pelo Copom |
129
- | 12 | CDI diária |
130
- | 4389 | CDI anualizada base 252 |
131
- | 226 | Taxa Referencial (TR) - diária |
132
- | 256 | Taxa de Juros de Longo Prazo (TJLP) |
133
-
134
- ### Inflação (30+ séries)
135
-
136
- | Código | Descrição |
137
- |--------|-----------|
138
- | 433 | IPCA - Variação mensal |
139
- | 13522 | IPCA - Acumulado 12 meses |
140
- | 7478 | IPCA-15 - Variação mensal |
141
- | 188 | INPC - Variação mensal |
142
- | 189 | IGP-M - Variação mensal |
143
- | 190 | IGP-DI - Variação mensal |
144
- | 7447 | IGP-10 - Variação mensal |
145
- | 10841-10850 | IPCA por grupo (Alimentação, Habitação, Transportes, etc.) |
146
- | 4449 | IPCA - Preços administrados |
147
- | 11428 | IPCA - Preços livres |
148
- | 16121-16122 | IPCA - Núcleos |
149
-
150
- ### Câmbio (15+ séries)
151
-
152
- | Código | Descrição |
153
- |--------|-----------|
154
- | 1 | Dólar americano (venda) |
155
- | 10813 | Dólar americano (compra) |
156
- | 3698/3697 | Dólar PTAX (venda/compra) |
157
- | 21619/21620 | Euro (venda/compra) |
158
- | 21623/21624 | Libra Esterlina (venda/compra) |
159
- | 21621/21622 | Iene (venda/compra) |
160
- | 21637/21638 | Peso Argentino (venda/compra) |
161
- | 21639/21640 | Yuan Chinês (venda/compra) |
162
-
163
- ### Atividade Econômica (25+ séries)
164
-
165
- | Código | Descrição |
166
- |--------|-----------|
167
- | 4380 | PIB mensal (R$ milhões) |
168
- | 4382 | PIB acumulado 12 meses (R$ milhões) |
169
- | 4385 | PIB mensal em US$ |
170
- | 7324 | PIB anual em US$ |
171
- | 24363/24364 | IBC-Br (sem/com ajuste sazonal) |
172
- | 29601-29606 | IBC-Br setorial (Agropecuária, Indústria, Serviços) |
173
- | 22099 | PIB trimestral - Taxa de variação |
174
- | 21859 | Produção industrial - Variação mensal |
175
- | 21862 | Utilização da capacidade instalada |
176
-
177
- ### Emprego (10+ séries)
178
-
179
- | Código | Descrição |
180
- |--------|-----------|
181
- | 24369 | Taxa de desocupação - PNAD Contínua |
182
- | 24370 | Taxa de participação na força de trabalho |
183
- | 24380 | Rendimento médio real |
184
- | 24381 | Massa de rendimento real |
185
- | 28561 | CAGED - Saldo de empregos formais |
186
-
187
- ### Fiscal (10+ séries)
188
-
189
- | Código | Descrição |
190
- |--------|-----------|
191
- | 4503 | Dívida líquida do setor público (% PIB) |
192
- | 4513 | Dívida bruta do governo geral (% PIB) |
193
- | 4537 | Resultado primário (% PIB) |
194
- | 4539 | Resultado nominal (% PIB) |
195
- | 5364 | Receita total do governo central |
196
-
197
- ### Setor Externo (15+ séries)
198
-
199
- | Código | Descrição |
200
- |--------|-----------|
201
- | 3546 | Reservas internacionais - diário |
202
- | 22707 | Balança comercial - Saldo mensal |
203
- | 22708 | Exportação de bens - mensal |
204
- | 22709 | Importação de bens - mensal |
205
- | 22701 | Transações correntes - Saldo |
206
- | 22846 | Investimento direto no país |
207
- | 13690 | Dívida externa total |
208
-
209
- ### Crédito (30+ séries)
210
-
211
- | Código | Descrição |
212
- |--------|-----------|
213
- | 20539 | Saldo de crédito - Total |
214
- | 20540/20541 | Saldo de crédito - PF/PJ |
215
- | 20714 | Taxa média de juros - Total |
216
- | 20749 | Taxa média - Aquisição de veículos |
217
- | 20772 | Taxa média - Financiamento imobiliário |
218
- | 20783 | Spread médio - Total |
219
- | 21082 | Inadimplência - Total |
220
- | 21128/21129 | Inadimplência - Cartão de crédito |
221
-
222
- ### Agregados Monetários
223
-
224
- | Código | Descrição |
225
- |--------|-----------|
226
- | 1788 | Base monetária |
227
- | 27788-27791 | Meios de pagamento M1, M2, M3, M4 |
228
- | 27815 | Multiplicador monetário |
229
-
230
- ### Poupança
231
-
232
- | Código | Descrição |
233
- |--------|-----------|
234
- | 25 | Poupança - Rendimento mensal |
235
- | 195 | Poupança - Saldo total |
236
- | 7165 | Poupança - Captação líquida |
237
-
238
- ### Índices de Mercado
239
-
240
- | Código | Descrição |
241
- |--------|-----------|
133
+ ## Series Catalog (150+)
134
+
135
+ The server includes a catalog of 150+ series organized in 12 categories.
136
+
137
+ ### Interest Rates
138
+
139
+ | Code | Description |
140
+ |------|-------------|
141
+ | 11 | Selic rate - monthly accumulated |
142
+ | 432 | Selic rate - annualized (base 252) |
143
+ | 1178 | Selic target rate (Copom) |
144
+ | 12 | CDI daily rate |
145
+ | 4389 | CDI annualized (base 252) |
146
+ | 226 | Reference Rate (TR) - daily |
147
+ | 256 | Long-Term Interest Rate (TJLP) |
148
+
149
+ ### Inflation (30+ series)
150
+
151
+ | Code | Description |
152
+ |------|-------------|
153
+ | 433 | IPCA - Monthly change |
154
+ | 13522 | IPCA - 12-month accumulated |
155
+ | 7478 | IPCA-15 - Monthly change |
156
+ | 188 | INPC - Monthly change |
157
+ | 189 | IGP-M - Monthly change |
158
+ | 190 | IGP-DI - Monthly change |
159
+ | 7447 | IGP-10 - Monthly change |
160
+ | 10841-10850 | IPCA by group (Food, Housing, Transportation, etc.) |
161
+ | 4449 | IPCA - Administered prices |
162
+ | 11428 | IPCA - Market prices |
163
+ | 16121-16122 | IPCA - Core measures |
164
+
165
+ ### Exchange Rates (15+ series)
166
+
167
+ | Code | Description |
168
+ |------|-------------|
169
+ | 1 | USD/BRL - US Dollar (sell) |
170
+ | 10813 | USD/BRL - US Dollar (buy) |
171
+ | 3698/3697 | USD/BRL PTAX (sell/buy) |
172
+ | 21619/21620 | EUR/BRL - Euro (sell/buy) |
173
+ | 21623/21624 | GBP/BRL - British Pound (sell/buy) |
174
+ | 21621/21622 | JPY/BRL - Japanese Yen (sell/buy) |
175
+ | 21637/21638 | ARS/BRL - Argentine Peso (sell/buy) |
176
+ | 21639/21640 | CNY/BRL - Chinese Yuan (sell/buy) |
177
+
178
+ ### Economic Activity (25+ series)
179
+
180
+ | Code | Description |
181
+ |------|-------------|
182
+ | 4380 | Monthly GDP (R$ millions) |
183
+ | 4382 | GDP - 12-month accumulated (R$ millions) |
184
+ | 4385 | Monthly GDP in USD |
185
+ | 7324 | Annual GDP in USD |
186
+ | 24363/24364 | IBC-Br Economic Activity Index (unadjusted/seasonally adjusted) |
187
+ | 29601-29606 | IBC-Br by sector (Agriculture, Industry, Services) |
188
+ | 22099 | Quarterly GDP - Rate of change |
189
+ | 21859 | Industrial production - Monthly change |
190
+ | 21862 | Installed capacity utilization |
191
+
192
+ ### Employment (10+ series)
193
+
194
+ | Code | Description |
195
+ |------|-------------|
196
+ | 24369 | Unemployment rate - PNAD |
197
+ | 24370 | Labor force participation rate |
198
+ | 24380 | Average real income |
199
+ | 24381 | Real income mass |
200
+ | 28561 | CAGED - Formal job creation |
201
+
202
+ ### Fiscal (10+ series)
203
+
204
+ | Code | Description |
205
+ |------|-------------|
206
+ | 4503 | Net public sector debt (% GDP) |
207
+ | 4513 | General government gross debt (% GDP) |
208
+ | 4537 | Primary balance (% GDP) |
209
+ | 4539 | Nominal balance (% GDP) |
210
+ | 5364 | Central government total revenue |
211
+
212
+ ### External Sector (15+ series)
213
+
214
+ | Code | Description |
215
+ |------|-------------|
216
+ | 3546 | International reserves - daily |
217
+ | 22707 | Trade balance - Monthly |
218
+ | 22708 | Exports - Monthly |
219
+ | 22709 | Imports - Monthly |
220
+ | 22701 | Current account - Balance |
221
+ | 22846 | Foreign direct investment |
222
+ | 13690 | Total external debt |
223
+
224
+ ### Credit (30+ series)
225
+
226
+ | Code | Description |
227
+ |------|-------------|
228
+ | 20539 | Total credit balance |
229
+ | 20540/20541 | Credit balance - Individuals/Corporations |
230
+ | 20714 | Average interest rate - Total |
231
+ | 20749 | Average rate - Vehicle financing |
232
+ | 20772 | Average rate - Mortgage |
233
+ | 20783 | Average spread - Total |
234
+ | 21082 | Default rate - Total |
235
+ | 21128/21129 | Default rate - Credit card |
236
+
237
+ ### Monetary Aggregates
238
+
239
+ | Code | Description |
240
+ |------|-------------|
241
+ | 1788 | Monetary base |
242
+ | 27788-27791 | Money supply M1, M2, M3, M4 |
243
+ | 27815 | Money multiplier |
244
+
245
+ ### Savings
246
+
247
+ | Code | Description |
248
+ |------|-------------|
249
+ | 25 | Savings - Monthly yield |
250
+ | 195 | Savings - Total balance |
251
+ | 7165 | Savings - Net deposits |
252
+
253
+ ### Market Indices
254
+
255
+ | Code | Description |
256
+ |------|-------------|
242
257
  | 12466 | IMA-B |
243
258
  | 12467 | IMA-B5 |
244
259
  | 12468 | IMA-B5+ |
245
- | 7832 | Ibovespa mensal |
260
+ | 7832 | Ibovespa - Monthly |
246
261
 
247
- ### Expectativas (Focus)
262
+ ### Expectations (Focus Survey)
248
263
 
249
- | Código | Descrição |
250
- |--------|-----------|
251
- | 29033/29034 | Expectativa IPCA (ano corrente/próximo) |
252
- | 29035/29036 | Expectativa Selic (ano corrente/próximo) |
253
- | 29037/29038 | Expectativa PIB (ano corrente/próximo) |
254
- | 29039/29040 | Expectativa Câmbio (ano corrente/próximo) |
264
+ | Code | Description |
265
+ |------|-------------|
266
+ | 29033/29034 | IPCA expectation (current/next year) |
267
+ | 29035/29036 | Selic expectation (current/next year) |
268
+ | 29037/29038 | GDP expectation (current/next year) |
269
+ | 29039/29040 | Exchange rate expectation (current/next year) |
255
270
 
256
- ## Encontrar Outras Séries
271
+ ## Finding Other Series
257
272
 
258
- O SGS possui mais de 18.000 séries temporais. Para encontrar o código de outras séries:
273
+ The SGS database contains over 18,000 time series. To find codes for other series:
259
274
 
260
- 1. Acesse o [Portal SGS do BCB](https://www3.bcb.gov.br/sgspub/)
261
- 2. Use a busca para encontrar a série desejada
262
- 3. Anote o código da série
263
- 4. Use esse código nas ferramentas deste servidor
275
+ 1. Visit the [BCB SGS Portal](https://www3.bcb.gov.br/sgspub/)
276
+ 2. Search for the desired series
277
+ 3. Note the series code
278
+ 4. Use that code with this server's tools
264
279
 
265
- ## Características Técnicas
280
+ ## Technical Details
266
281
 
267
- ### Robustez
282
+ ### Robustness
268
283
 
269
- - **Timeout**: 30 segundos por requisição (evita travamentos)
270
- - **Retry automático**: 3 tentativas com backoff exponencial (1s, 2s, 4s)
271
- - **Tratamento de erros**: Mensagens claras em português
284
+ - **Timeout**: 30 seconds per request (prevents hanging)
285
+ - **Auto-retry**: 3 attempts with exponential backoff (1s, 2s, 4s)
286
+ - **Error handling**: Clear error messages
272
287
 
273
- ### Busca Inteligente
288
+ ### Smart Search
274
289
 
275
- A ferramenta `bcb_buscar_serie` normaliza os termos de busca, permitindo encontrar séries mesmo sem acentos:
290
+ The `bcb_buscar_serie` tool normalizes search terms, allowing you to find series even without Portuguese accents:
276
291
 
277
- - `"inflacao"` → encontra "Inflação"
278
- - `"cambio"` → encontra "Câmbio"
279
- - `"credito"` → encontra "Crédito"
292
+ - `"inflacao"` → finds "Inflação"
293
+ - `"cambio"` → finds "Câmbio"
294
+ - `"credito"` → finds "Crédito"
280
295
 
281
- ## Desenvolvimento
296
+ ## Development
282
297
 
283
- ### Requisitos
298
+ ### Requirements
284
299
 
285
300
  - Node.js >= 18.0.0
286
301
 
@@ -298,69 +313,82 @@ npm install
298
313
  npm run build
299
314
  ```
300
315
 
301
- ### Teste local
316
+ ### Local testing (stdio)
302
317
 
303
318
  ```bash
304
319
  npm run dev
305
320
  ```
306
321
 
307
- Ou use o MCP Inspector:
322
+ ### Local testing (HTTP worker)
323
+
324
+ ```bash
325
+ npm run dev:worker
326
+ ```
327
+
328
+ Or use the MCP Inspector:
308
329
 
309
330
  ```bash
310
331
  npx @modelcontextprotocol/inspector npm run dev
311
332
  ```
312
333
 
313
- ## API do BCB
334
+ ## BCB API
314
335
 
315
- Este servidor utiliza a API pública do Banco Central do Brasil:
336
+ This server uses the Brazilian Central Bank's public API:
316
337
 
317
- - **Endpoint base:** `https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados`
318
- - **Formato:** JSON
319
- - **Autenticação:** Nenhuma (API pública)
320
- - **Documentação:** [Dados Abertos BCB](https://dadosabertos.bcb.gov.br/)
338
+ - **Base endpoint:** `https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados`
339
+ - **Format:** JSON
340
+ - **Authentication:** None (public API)
341
+ - **Documentation:** [BCB Open Data](https://dadosabertos.bcb.gov.br/)
321
342
 
322
343
  ## Changelog
323
344
 
345
+ ### v1.2.0
346
+
347
+ - HTTP endpoint via Cloudflare Workers (`https://bcb.sidneybissoli.workers.dev`)
348
+ - Published on Smithery.ai
349
+ - Refactored: tool logic extracted to `src/tools.ts` (shared between stdio and HTTP)
350
+
324
351
  ### v1.1.0
325
352
 
326
- - ✨ Nova ferramenta `bcb_variacao` para cálculo de variação percentual
327
- - ✨ Nova ferramenta `bcb_comparar` para comparação de múltiplas séries
328
- - 🔧 Timeout de 30 segundos nas requisições
329
- - 🔧 Retry automático com backoff exponencial (3 tentativas)
330
- - 🔧 Busca normalizada (aceita termos sem acentos)
331
- - 📊 Estatísticas adicionais (máximo, mínimo, média, amplitude)
353
+ - New tool `bcb_variacao` for percentage variation calculation
354
+ - New tool `bcb_comparar` for comparing multiple series
355
+ - 30-second timeout on requests
356
+ - Auto-retry with exponential backoff (3 attempts)
357
+ - Normalized search (accent-insensitive)
358
+ - Additional statistics (max, min, average, range)
332
359
 
333
360
  ### v1.0.0
334
361
 
335
- - 🎉 Lançamento inicial
336
- - 6 ferramentas básicas
337
- - Catálogo com 150+ séries
362
+ - Initial release
363
+ - 6 basic tools
364
+ - Catalog with 150+ series
338
365
 
339
- ## Contribuição
366
+ ## Contributing
340
367
 
341
- Contribuições são bem-vindas! Por favor:
368
+ Contributions are welcome! Please:
342
369
 
343
- 1. Faça um fork do repositório
344
- 2. Crie uma branch para sua feature (`git checkout -b feature/nova-feature`)
345
- 3. Commit suas mudanças (`git commit -m 'Adiciona nova feature'`)
346
- 4. Push para a branch (`git push origin feature/nova-feature`)
347
- 5. Abra um Pull Request
370
+ 1. Fork the repository
371
+ 2. Create a feature branch (`git checkout -b feature/new-feature`)
372
+ 3. Commit your changes (`git commit -m 'Add new feature'`)
373
+ 4. Push to the branch (`git push origin feature/new-feature`)
374
+ 5. Open a Pull Request
348
375
 
349
- ## Licença
376
+ ## License
350
377
 
351
- MIT - veja [LICENSE](LICENSE) para detalhes.
378
+ MIT - see [LICENSE](LICENSE) for details.
352
379
 
353
- ## Autor
380
+ ## Author
354
381
 
355
- **Sidney Bissoli**
382
+ **Sidney da Silva Pereira Bissoli**
356
383
 
357
384
  - GitHub: [@SidneyBissoli](https://github.com/SidneyBissoli)
358
385
  - Email: sbissoli76@gmail.com
359
386
 
360
- ## Links Úteis
387
+ ## Useful Links
361
388
 
362
- - [Portal SGS BCB](https://www3.bcb.gov.br/sgspub/)
363
- - [Dados Abertos BCB](https://dadosabertos.bcb.gov.br/)
389
+ - [BCB SGS Portal](https://www3.bcb.gov.br/sgspub/)
390
+ - [BCB Open Data](https://dadosabertos.bcb.gov.br/)
364
391
  - [Model Context Protocol](https://modelcontextprotocol.io/)
365
392
  - [MCP Registry](https://registry.modelcontextprotocol.io/)
393
+ - [Smithery: bcb-br-mcp](https://smithery.ai/server/@sidneybissoli/bcb-br-mcp)
366
394
  - [npm: bcb-br-mcp](https://www.npmjs.com/package/bcb-br-mcp)