checkpj-mcp-server

MCP server for CheckPJ — Brazilian company data API.

Exposes 4 tools for Claude and other MCP-compatible AI assistants:

• lookup_company — Look up a company by CNPJ

• search_companies — Search companies by name, CNAE, state, or municipality

• get_health_score — Get a company's health/risk score

• validate_cnpj — Check if a CNPJ is valid and active

Setup

Claude Code

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "checkpj": {
      "command": "node",
      "args": ["/path/to/checkpj-mcp/dist/index.js"],
      "env": {
        "CHECKPJ_API_KEY": "your-api-key"
      }
    }
  }
}

npm (global install)

npm install -g checkpj-mcp-server

Then use checkpj-mcp as the command.

Configuration

Set CHECKPJ_API_KEY environment variable for authenticated access. Without it, the free tier (limited requests) is used.

Development

bun install
bun build src/index.ts --outdir dist --target node
node dist/index.js