Skip to main content
Glama

Brasil API MCP

Brasil API MCP

A Model Context Protocol (MCP) server that provides tools to query various Brazilian data services via the Brasil API.

Overview

Brasil API MCP is a bridge that connects AI assistants to Brazilian public data services through the standardized Model Context Protocol. It provides access to various information such as:

  • Postal Codes (CEP)
  • Company Registration (CNPJ)
  • Bank information
  • Area codes (DDD)
  • IBGE (Brazilian Institute of Geography and Statistics) data
  • Currency exchange rates
  • Domain registration status (.br domains)

Installation

# Clone the repository git clone https://github.com/guilhermelirio/brasil-api-mcp cd brasil-api-mcp # Install dependencies npm install # Build the project npm run build

Usage

To run the server:

npm start

This will start the MCP server that communicates via standard input/output (stdio).

Available Tools

CEP (Postal Codes)

  • cep-search - Query address information from a Brazilian postal code (CEP)

CNPJ (Company Registration)

  • cnpj-search - Query information about a Brazilian company by its CNPJ (National Registry of Legal Entities)

Banks

  • bank-search - Find information about a Brazilian bank by its code
  • bank-list - List all Brazilian banks

DDD (Area Codes)

  • ddd-search - Find information about a Brazilian area code (DDD)

IBGE (Geography and Statistics)

  • ibge-states-list - List all Brazilian states with their information
  • ibge-state-search - Find information about a Brazilian state by its code or abbreviation
  • ibge-municipalities-list - List all municipalities of a Brazilian state by its abbreviation

Cambio (Currency Exchange)

  • cambio-currencies-list - List all available currencies for exchange rates
  • cambio-rate - Get exchange rates for a specific currency on a specific date

Registro BR (Domain Registration)

  • registrobr-domain-check - Check the status and availability of a .br domain name

Integration Examples

Querying a Brazilian Address by Postal Code

// Sample request to the CEP tool const response = await callMcpTool("cep-search", { cep: "01001000" }); // Response provides address details: // { // cep: "01001000", // state: "SP", // city: "São Paulo", // neighborhood: "Sé", // street: "Praça da Sé", // service: "viacep" // }

Getting Currency Exchange Rates

// Sample request to get USD exchange rate const response = await callMcpTool("cambio-rate", { currency: "USD", date: "2023-08-10" }); // Response provides detailed exchange information

Credits

This project uses the Brasil API service, which aggregates various APIs related to Brazilian public data. Special thanks to the Brasil API team for providing this valuable service to the community.

License

MIT © Guilherme Lirio Tomasi de Oliveira

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.

  1. Overview
    1. Installation
      1. Usage
        1. Available Tools
          1. CEP (Postal Codes)
          2. CNPJ (Company Registration)
          3. Banks
          4. DDD (Area Codes)
          5. IBGE (Geography and Statistics)
          6. Cambio (Currency Exchange)
          7. Registro BR (Domain Registration)
        2. Integration Examples
          1. Querying a Brazilian Address by Postal Code
          2. Getting Currency Exchange Rates
        3. Credits
          1. License

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
              Last updated -
              13
              Python
              • Apple
              • Linux
            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server providing AI assistants with access to healthcare data tools, including FDA drug information, PubMed research, health topics, clinical trials, and medical terminology lookup.
              Last updated -
              7
              16
              16
              JavaScript
              • Linux
              • Apple
            • -
              security
              F
              license
              -
              quality
              A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
              Last updated -
              16
              1
              TypeScript
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
              Last updated -
              1
              Python

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/guilhermelirio/brasil-api-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server