{"_id":"@codespar/mcp-brasil-api","_rev":"6-991fc7f4e4d3b12df6171451846fd613","name":"@codespar/mcp-brasil-api","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-brasil-api","version":"0.1.0","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"license":"MIT","_id":"@codespar/mcp-brasil-api@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-brasil-api":"dist/index.js"},"dist":{"shasum":"db1f1c9b7d75285c72c367d22774ccb2c335c777","tarball":"https://registry.npmjs.org/@codespar/mcp-brasil-api/-/mcp-brasil-api-0.1.0.tgz","fileCount":4,"integrity":"sha512-XYJMfrN10sBtwWNZh9yvptnF058YPZDhq8i1fpY2sTRoRvTixDYktjiuUCUSfs0Ma3HyUH+GOaR5TXMWqeOi2g==","signatures":[{"sig":"MEUCIHsP9ocfbDPHiMFJHTj0zi5J+VCcp8CxC44BW+QHVcYHAiEA55BA/5j0QVdRK9G3GqW3kCgsbf1G0FSrd3i2i+5Zbwc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14957},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-brasil-api_0.1.0_1774923316852_0.6263864869022564","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-brasil-api","version":"0.1.2","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"license":"MIT","_id":"@codespar/mcp-brasil-api@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-brasil-api":"dist/index.js"},"dist":{"shasum":"e3ade203eb597bad12a1f631aa4e5def063c9713","tarball":"https://registry.npmjs.org/@codespar/mcp-brasil-api/-/mcp-brasil-api-0.1.2.tgz","fileCount":7,"integrity":"sha512-Xs7nugIVqHA0fJdvJhR+01R9WKDPIyGHF/sBMmY/vCdwx8LYMz3FrSOCBiT7KQTtK3zQ7bQvIaJAwgZ4SjLrLw==","signatures":[{"sig":"MEYCIQDu86OBEr5y6LL5ocUnOUdtCoUXUnXico6FcHrCPx3KvgIhAIOYnEwbu7tCtrs95srPw5aTREtqAeiky/vTOMP0Qk2e","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38132},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-brasil-api","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-brasil-api_0.1.2_1775953727986_0.7987019398954895","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-brasil-api","version":"0.2.0","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"license":"MIT","_id":"@codespar/mcp-brasil-api@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-brasil-api":"dist/index.js"},"dist":{"shasum":"4383e3925436d3c709af4e7a4245983a132c225a","tarball":"https://registry.npmjs.org/@codespar/mcp-brasil-api/-/mcp-brasil-api-0.2.0.tgz","fileCount":7,"integrity":"sha512-dq72ydE3MJ3TWuZY/QgtLelmVRgZthlatMKF4m0Y9tOhx7roFfTOK1a4zvUBU+wpwKooZzycymlHuiXV2ozRcA==","signatures":[{"sig":"MEUCIQDLlu7q0qtYJdBgyqaLOLXFHJTBlS98mWBHa3MNK5CSNwIgcCDyMD6eA7CzTMbnkj902RieH1XcDZtnztX7QaMR5qA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48774},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a0e321bd6cd8470b3e3ba7c7511bafb4a04eea93","mcpName":"io.github.codespar/mcp-brasil-api","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-brasil-api_0.2.0_1777119063115_0.2905637104984984","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-brasil-api","version":"0.2.1","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"license":"MIT","_id":"@codespar/mcp-brasil-api@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-brasil-api":"dist/index.js"},"dist":{"shasum":"0d40681effc8e17d54184da67fde1d36974b1ce4","tarball":"https://registry.npmjs.org/@codespar/mcp-brasil-api/-/mcp-brasil-api-0.2.1.tgz","fileCount":7,"integrity":"sha512-lXEUvqu979Q7tZjTKOvdDYt0Olzvphp/5tb+AfTnUMNg2z1wJyunOxZ/nYL6JcpOmCve/u6Wey0DND4SMsvY0w==","signatures":[{"sig":"MEUCIQCatz1wECSl52UnO82byI6+6ldfKwMStnVqXw+Kg/MD3AIgFnnzWJCeBPzQm4Hw0hK0CUdTUGpj4C3ReuYndm/zvJA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49978},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-brasil-api","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-brasil-api_0.2.1_1777123108680_0.5146478591277137","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-brasil-api","version":"0.2.2","description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","type":"module","main":"./dist/index.js","bin":{"mcp-brasil-api":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"mcpName":"io.github.codespar/mcp-brasil-api","_id":"@codespar/mcp-brasil-api@0.2.2","gitHead":"776ee260ec81f40a78c5f23f4ae78d64b475c0fa","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-s+yejwAf62xSYM1/oaEKiSb2qyizJOgBUdE4CPBkH37HrdPJuYYsPCSi8eE9Ss5tjC55OhJFwmvXswaCYdoe5g==","shasum":"73786cda4c79d8eee358dcba0129be8a405ae41b","tarball":"https://registry.npmjs.org/@codespar/mcp-brasil-api/-/mcp-brasil-api-0.2.2.tgz","fileCount":7,"unpackedSize":51260,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDHY9tfsgj5D65xhhKt4GgEke0FPDkJ//w5079rqdz37AIhANy5NtIgTJrtytZUEj/s+fW2QB+6tVLCivD0VlRZSJ1I"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-brasil-api_0.2.2_1782149684267_0.011074676843164655"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:16.740Z","modified":"2026-06-22T17:34:44.619Z","0.1.0":"2026-03-31T02:15:16.989Z","0.1.2":"2026-04-12T00:28:48.146Z","0.2.0":"2026-04-25T12:11:03.274Z","0.2.1":"2026-04-25T13:18:28.825Z","0.2.2":"2026-06-22T17:34:44.421Z"},"license":"MIT","keywords":["mcp","brasil-api","cep","cnpj","fipe","brazil"],"description":"MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-brasil-api\n\n> MCP server for **BrasilAPI** — free public data APIs for CEP, CNPJ, banks, holidays, FIPE, and more\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-brasil-api)](https://www.npmjs.com/package/@codespar/mcp-brasil-api)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"brasil-api\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-brasil-api\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add brasil-api -- npx @codespar/mcp-brasil-api\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"brasil-api\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-brasil-api\"]\n    }\n  }\n}\n```\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `get_cep` | Look up address by CEP (Brazilian postal code) |\n| `get_cnpj` | Look up company information by CNPJ |\n| `get_banks` | List all Brazilian banks with codes and names |\n| `get_holidays` | List national holidays for a given year |\n| `get_fipe_brands` | List vehicle brands by type from FIPE table |\n| `get_fipe_price` | Get vehicle price from FIPE table by code |\n| `get_ddd` | Get state and cities for a DDD (area code) |\n| `get_isbn` | Look up book information by ISBN |\n| `get_ncm` | Look up NCM tax classification code |\n| `get_cptec_weather` | Get weather forecast for a city (CPTEC/INPE) |\n| `get_pix_participants` | List Pix participant institutions (PSPs/banks enrolled in Pix) |\n| `get_domain_info` | Look up .br domain registration info |\n| `get_ibge_municipalities` | List all municipalities for a Brazilian state (IBGE data) |\n| `get_tax_rates` | Get current Brazilian tax/economic rates (Selic, CDI, IPCA) |\n| `get_cptec_cities` | Search CPTEC/INPE cities by name for weather forecasts |\n| `get_cep_v1` | Look up address by CEP using BrasilAPI v1 (single-provider, often faster than v2) |\n| `get_fipe_vehicles` | List vehicle models for a given FIPE brand code and vehicle type |\n| `get_fipe_tables` | List FIPE reference tables (months/years available for FIPE queries) |\n| `get_cptec_airport_weather` | Get current airport weather (METAR) by ICAO code from CPTEC/INPE |\n| `get_cptec_capitals_weather` | Get current weather conditions for all Brazilian state capitals |\n| `get_cptec_ocean_forecast` | Get ocean/wave forecast for a coastal city (CPTEC/INPE) |\n| `get_ibge_states` | List all Brazilian states/UFs with IBGE codes and metadata |\n| `get_corretoras` | List all CVM-registered Brazilian brokerages (corretoras) |\n| `get_corretora` | Look up a single CVM-registered brokerage by CNPJ |\n\n## Authentication\n\nNo authentication required. BrasilAPI is a free public API.\n\n## Sandbox / Testing\n\nNo sandbox needed. BrasilAPI is free and open for all requests.\n\n### Get your credentials\n\nNo credentials needed. Just install and use.\n\n## Environment Variables\n\nNo environment variables required.\n\n## Roadmap\n\n### v0.2 (planned)\n- `get_pix_participants` — Get list of Pix participant institutions\n- `get_domain_info` — Get domain registration info\n- `get_vehicle_info` — Get vehicle info by license plate (FIPE)\n- `get_ibge_municipalities` — List municipalities by state (IBGE)\n- `get_tax_rates` — Get current tax rates (Selic, CDI, IPCA)\n\n### v0.3 (planned)\n- `get_cvm_funds` — Get investment fund data from CVM\n- `get_election_results` — Get election results by region\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [BrasilAPI Website](https://brasilapi.com.br)\n- [BrasilAPI Documentation](https://brasilapi.com.br/docs)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}