MCP Dev Brasil

The catalog exposes each provider as a separate npm package under the @codespar scope. Identify which service you need — for example @codespar/mcp-brasil-api for free public data (CEP, CNPJ), @codespar/mcp-asaas for the Asaas payment gateway, or @codespar/mcp-stripe-acp for Stripe's agentic commerce protocol.

# No-auth public server (try immediately):
npx @codespar/mcp-brasil-api

# Payment gateway server:
npx @codespar/mcp-asaas

# Alpha bank servers require @alpha tag:
npx @codespar/mcp-itau@alpha

Most providers require an API key obtained from their developer dashboard. Public servers like BrasilAPI require no credentials. For agentic protocol servers such as x402 (Coinbase) or UCP (Google), follow the respective provider's onboarding to get your key.

Open your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add an entry for each server you want to use.

{
  "mcpServers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    },
    "asaas": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-asaas"],
      "env": {
        "ASAAS_API_KEY": "your-api-key",
        "ASAAS_SANDBOX": "true"
      }
    },
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_..."
      }
    }
  }
}

Any server in the catalog can be launched as an HTTP endpoint that exposes /mcp (Streamable HTTP) and /health endpoints. This is useful for integrating with cloud-hosted AI agents or self-hosted orchestration pipelines.

# Run as HTTP server:
npx @codespar/mcp-asaas --http
# or via environment variable:
MCP_HTTP=true npx @codespar/mcp-asaas

Restart Claude Desktop (or your chosen client) so it picks up the updated config. The server will launch on demand when you start a conversation. You can verify it is working by asking Claude to look up a CNPJ or postal code.