Unified Brazilian Data Access Service (BrasilAPI Integrator)

Facilitate seamless data ingestion from various Brazilian information repositories through one cohesive service interface. Obtain critical details such as national addressing codes, telephony routing identifiers, banking system details, official observance calendars, and tax computation components via a consolidated access layer. Empower your sophisticated AI constructs and operational applications with accurate, up-to-date datasets curated by BrasilAPI.

Consult the comprehensive, official documentation published by BrasilAPI here.

Available Functions

This runtime exposes discrete functions corresponding to every accessible endpoint within the BrasilAPI ecosystem. Internally, communication is mediated by this JavaScript client library: https://github.com/WillianAgostini/brasilapi-js

Visit the Function Catalog on Smithery to examine the schema and test each data retrieval capability.

Development Lifecycle

To initiate local development, first acquire necessary dependencies:

npm install

Compile the server components:

npm run build

For iterative development with automatic recompilation:

npm run watch

Diagnostics

Debugging interactions over standard I/O (stdio) for MCP servers can present complexities. We highly recommend leveraging the dedicated MCP Inspector, accessible via a standard package script:

npm run inspector

To generate a fresh compilation followed immediately by inspection:

npm run build-and-inspect

The Inspector tool will furnish a network address for accessing browser-based debugging utilities.

Integration Pathways for Intelligent Systems

Deployment via Smithery

Execute the server deployment utilizing the Smithery Orchestrator automatically:

npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server

Configuration for Claude

To specifically tailor the installation for interaction with the Claude model:

npx -y @smithery/cli@latest install @mauricio-cantu/brasil-api-mcp-server --client claude

Integration with Cursor and Related Environments

Refer to the Service Landing Page on Smithery to discover alternative integration modalities, including support for Cursor and others.

Local Execution Procedure

Once this repository has been cloned, the service can be initiated using Node.js:

node /absolute/path/to/brasil-api-mcp-server/build/index.js

A Dockerfile is also present at the project root, enabling container image construction and deployment.

Service Capability Discovery

You can query the operational specifications of this MCP runtime using Smithery:

npx -y @smithery/cli@latest inspect @mauricio-cantu/brasil-api-mcp-server

This command details all exposed functions, their required arguments, and usage examples.

Project Organization

src/
  ├── apiClient/   # Core client for BrasilAPI interactions
  ├── tools/       # Implementations of individual data retrieval functions
  ├── types/       # Data structures and interface definitions
  ├── utils/       # Helper routines and auxiliary code
  └── index.ts     # Entry point: server bootstrapping and function registration