Implement APIBrasil MCP server for Brazilian data services

[Copilot]

Provides MCP server implementation for APIBrasil, enabling AI assistants to access Brazilian data services: CPF/CNPJ lookups, postal codes, vehicle information, FIPE pricing, package tracking, and WhatsApp messaging.

Implementation

Server Architecture

• TypeScript MCP server using @modelcontextprotocol/sdk over stdio transport
• APIBrasil REST client with bearer token + device token authentication
• 8 tools exposing Brazilian data services via standardized MCP protocol

Available Tools

• consulta_cpf / consulta_cnpj - Brazilian taxpayer registry lookups
• consulta_cep - Postal code to address resolution
• consulta_placa / consulta_fipe - Vehicle data and market pricing
• rastreio_correios - Correios package tracking
• whatsapp_send_text / whatsapp_send_file - WhatsApp messaging

Configuration
Environment-based credentials via APIBRASIL_BEARER_TOKEN and APIBRASIL_DEVICE_TOKEN. Claude Desktop config:

{
  "mcpServers": {
    "apibrasil": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "APIBRASIL_BEARER_TOKEN": "your_token",
        "APIBRASIL_DEVICE_TOKEN": "your_device_token"
      }
    }
  }
}

Structure

src/index.ts          # MCP server + APIBrasil client
package.json          # @modelcontextprotocol/sdk, axios
tsconfig.json         # ES2022 + Node16 modules
.env.example          # Credential template

Usage examples and contributing guidelines in USAGE.md and CONTRIBUTING.md.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• apibrasil.com.br
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
• modelcontextprotocol.io
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

apibrasil-mcp-client

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.