How do I use CPFHub MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CPFHub MCP Server look up CPF 529.982.247-25" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

CPFHub MCP Server

Official

by cpfhub

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

cpfhub-mcp: Official MCP Server for CPFHub.io

🇺🇸 English | 🇧🇷 Português

Official Model Context Protocol (MCP) server for CPFHub.io — Brazilian CPF Lookup API for AI agents.

npm version License: MIT

What is CPFHub.io?

CPFHub.io is a REST API that returns identity data — full name, gender, and date of birth — from any Brazilian CPF number, in ~300ms, with 99.9% uptime and full LGPD compliance.

10M+ CPFs queried · 1,300+ active companies · 99.9% uptime

Related MCP server: mcp-brasil

Tools

This MCP server exposes the following tools:

Tool	Description
`get_person_by_cpf`	Retrieve identity data (full name, gender, date of birth) from a Brazilian CPF number
`get_quota_information`	Retrieve remaining API credits and current plan status

Tool Definition

{
  "name": "get_person_by_cpf",
  "description": "Retrieve identity data from a Brazilian CPF number",
  "parameters": {
    "type": "object",
    "properties": {
      "cpf": {
        "type": "string",
        "description": "Brazilian CPF number (digits only or formatted as XXX.XXX.XXX-XX)"
      }
    },
    "required": ["cpf"]
  }
}

Quick Start

# Set your API key
export CPFHUB_API_KEY=your_api_key_here

# Run the MCP server directly with npx (no install needed)
npx @cpfhub/mcp

Get your free API key at app.cpfhub.io — no credit card required.

curl Example

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "success": true,
  "data": {
    "cpf": "12345678909",
    "name": "Fulano de Tal",
    "nameUpper": "FULANO DE TAL",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
  }
}

Configuration

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "cpfhub": {
      "command": "npx",
      "args": ["-y", "@cpfhub/mcp"],
      "env": {
        "CPFHUB_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor

Go to Settings > Features > MCP.
Click + Add New MCP Server.
Name: CPFHub
Type: command
Command: export CPFHUB_API_KEY=YOUR_API_KEY_HERE && npx -y @cpfhub/mcp

Windsurf

Add to your MCP configuration file:

{
  "mcpServers": {
    "cpfhub": {
      "command": "npx",
      "args": ["-y", "@cpfhub/mcp"],
      "env": {
        "CPFHUB_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

OpenAI Function Calling Example

import os
import json
import requests
from openai import OpenAI

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
CPFHUB_API_KEY = os.environ["CPFHUB_API_KEY"]

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_person_by_cpf",
            "description": "Retrieve identity data from a Brazilian CPF number",
            "parameters": {
                "type": "object",
                "properties": {
                    "cpf": {"type": "string", "description": "Brazilian CPF number"}
                },
                "required": ["cpf"],
            },
        },
    }
]

def get_person_by_cpf(cpf: str) -> dict:
    response = requests.get(
        f"https://api.cpfhub.io/cpf/{cpf.replace('.', '').replace('-', '')}",
        headers={"x-api-key": CPFHUB_API_KEY},
    )
    return response.json()

messages = [{"role": "user", "content": "Who is the person with CPF 123.456.789-09?"}]
response = client.chat.completions.create(model="gpt-4o", messages=messages, tools=tools)
message = response.choices[0].message

if message.tool_calls:
    args = json.loads(message.tool_calls[0].function.arguments)
    result = get_person_by_cpf(args["cpf"])
    print(result)

LangChain Example

See examples/langchain_example.py for a full LangChain agent integration example.

Requirements

Node.js 18 or higher
A valid API key from app.cpfhub.io

Links

Resource	URL
Documentation	https://cpfhub.io/documentacao
Dashboard	https://app.cpfhub.io
OpenAPI Specification	https://github.com/cpfhub/cpfhub-openapi
Node.js SDK	https://github.com/cpfhub/cpfhub-node
Python SDK	https://github.com/cpfhub/cpfhub-python
All SDKs	https://github.com/cpfhub

License

MIT © CPFHub.io

Português

🇺🇸 English | 🇧🇷 Português

Servidor Model Context Protocol (MCP) oficial para CPFHub.io — API de Consulta de CPF Brasileiro para agentes de IA.

O que é o CPFHub.io?

O CPFHub.io é uma API REST que retorna dados de identidade — nome completo, gênero e data de nascimento — de qualquer CPF brasileiro, em ~300ms, com 99,9% de uptime e total conformidade com a LGPD.

10M+ CPFs consultados · 1.300+ empresas ativas · 99,9% uptime

Ferramentas (Tools)

Este servidor MCP expõe as seguintes ferramentas:

Ferramenta	Descrição
`get_person_by_cpf`	Recupera dados de identidade (nome completo, gênero, data de nascimento) a partir de um CPF brasileiro
`get_quota_information`	Recupera os créditos de API restantes e o status do plano atual

Definição da Ferramenta

{
  "name": "get_person_by_cpf",
  "description": "Retrieve identity data from a Brazilian CPF number",
  "parameters": {
    "type": "object",
    "properties": {
      "cpf": {
        "type": "string",
        "description": "Brazilian CPF number (digits only or formatted as XXX.XXX.XXX-XX)"
      }
    },
    "required": ["cpf"]
  }
}

Início Rápido

# Configure sua chave de API
export CPFHUB_API_KEY=sua_chave_de_api_aqui

# Execute o servidor MCP diretamente com npx (sem instalação)
npx @cpfhub/mcp

Obtenha sua chave de API gratuita em app.cpfhub.io — sem cartão de crédito.

Exemplo curl

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: SUA_CHAVE_DE_API"

Resposta:

{
  "success": true,
  "data": {
    "cpf": "12345678909",
    "name": "Fulano de Tal",
    "nameUpper": "FULANO DE TAL",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
  }
}

Configuração

Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "cpfhub": {
      "command": "npx",
      "args": ["-y", "@cpfhub/mcp"],
      "env": {
        "CPFHUB_API_KEY": "SUA_CHAVE_DE_API_AQUI"
      }
    }
  }
}

Cursor

Acesse Settings > Features > MCP.
Clique em + Add New MCP Server.
Nome: CPFHub
Tipo: command
Comando: export CPFHUB_API_KEY=SUA_CHAVE_DE_API_AQUI && npx -y @cpfhub/mcp

Windsurf

Adicione ao seu arquivo de configuração MCP:

{
  "mcpServers": {
    "cpfhub": {
      "command": "npx",
      "args": ["-y", "@cpfhub/mcp"],
      "env": {
        "CPFHUB_API_KEY": "SUA_CHAVE_DE_API_AQUI"
      }
    }
  }
}

Exemplo com OpenAI Function Calling

import os
import json
import requests
from openai import OpenAI

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
CPFHUB_API_KEY = os.environ["CPFHUB_API_KEY"]

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_person_by_cpf",
            "description": "Retrieve identity data from a Brazilian CPF number",
            "parameters": {
                "type": "object",
                "properties": {
                    "cpf": {"type": "string", "description": "Brazilian CPF number"}
                },
                "required": ["cpf"],
            },
        },
    }
]

def get_person_by_cpf(cpf: str) -> dict:
    response = requests.get(
        f"https://api.cpfhub.io/cpf/{cpf.replace('.', '').replace('-', '')}",
        headers={"x-api-key": CPFHUB_API_KEY},
    )
    return response.json()

messages = [{"role": "user", "content": "Quem é a pessoa com CPF 123.456.789-09?"}]
response = client.chat.completions.create(model="gpt-4o", messages=messages, tools=tools)
message = response.choices[0].message

if message.tool_calls:
    args = json.loads(message.tool_calls[0].function.arguments)
    result = get_person_by_cpf(args["cpf"])
    print(result)

Exemplo com LangChain

Veja examples/langchain_example.py para um exemplo completo de integração com agente LangChain.

Requisitos

Node.js 18 ou superior
Uma chave de API válida de app.cpfhub.io

Links

Recurso	URL
Documentação	https://cpfhub.io/documentacao
Dashboard	https://app.cpfhub.io
Especificação OpenAPI	https://github.com/cpfhub/cpfhub-openapi
SDK Node.js	https://github.com/cpfhub/cpfhub-node
SDK Python	https://github.com/cpfhub/cpfhub-python
Todos os SDKs	https://github.com/cpfhub

Licença

Available Tools

2 tools

get_person_by_cpfA

Retrieve identity data (full name, gender, and date of birth) from a Brazilian CPF number.

Name	Required	Description	Default
`cpf`	Yes	Brazilian CPF number (digits only or formatted as XXX.XXX.XXX-XX)

get_quota_informationA

Retrieve the remaining API credits and current plan status for the authenticated account.

Name	Required	Description	Default
No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

2 tool updatesv1.0.1Jul 28, 2026
- First observedget_person_by_cpf
- First observedget_quota_information

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.8/5.0

Scored 2026-07-28 14:40 across 2 tools

Disambiguation5/5

The two tools serve completely different purposes: one retrieves personal data from a CPF, the other checks API quota. There is no overlap or ambiguity.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern using snake_case (get_person_by_cpf, get_quota_information). The naming is clear and predictable.

Tool Count3/5

With only 2 tools, the server feels thin for a service called 'CPFHub', which implies a broader range of CPF-related operations. However, the tools are focused and may be sufficient for a narrow use case.

Completeness3/5

The server provides only one data retrieval tool for CPF lookup and a quota tool. Missing operations like CPF validation or list/update functions are notable gaps for a CPF-focused server, but the core lookup is covered.

Resources

Related MCP Connectors

UnifAPI
com.unifapi
Hosted MCP server for live public-data APIs and Skills for AI agents.
Open Data Search AI & Machine Learning
2
https://mcp.unifapi.com
openfolio
io.github.dodenbach
Agent-native MCP server over 49M+ US public and government records, privacy-first, always current.
Government Data Open Data Search
1
https://dtodenbach--pq-api-serve.modal.run/mcp
Artificial Wit AI
com.artificialwit
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
ERP Systems CRM Knowledge & Memory
2
https://api.artificialwit.com/mcp
MaxMind minFraud MCP by usefulapiA
io.usefulapi
MCP server for MaxMind minFraud — score transactions for fraud risk from your AI assistant.
Security Finance
2
https://maxmind-minfraud.usefulapi.io/mcp

Related MCP Servers

mcp-brasil
Government Data Open Data
bob-reis
A
license
A
quality
D
maintenance
MCP Server for accessing 36 Brazilian public data sources and 1 agent, enabling AI agents to query government data on economy, legislation, transparency, judiciary, elections, environment, health, and more.
Updated 5 months ago (2026-06-12 02:53 UTC)
6
MIT
mcp-brasil
Government Data Open Data Research & Data
davidlustosa2
A
license
Not graded
quality
D
maintenance
MCP server that connects AI agents to 28 Brazilian public APIs, providing tools to query government data on economy, legislation, transparency, judiciary, elections, environment, health, and more.
Updated 7 months ago (2026-03-27 17:26 UTC)
MIT
Cadastro PF Básico
Government Data
mcp-dir
A
license
Not graded
quality
D
maintenance
Enables querying basic Brazilian CPF registration data (name, status, birth date) via a hosted MCP server with a single read-only tool, usable from any MCP client.
Updated 3 months ago (2026-08-15 19:46 UTC)
MIT
Receita Federal PF
Government Data Open Data
mcp-dir
A
license
Not graded
quality
D
maintenance
Enables querying the Brazilian Federal Revenue registration status of an individual using CPF and birth date, with a read-only MCP tool accessible from various AI clients.
Updated 3 months ago (2026-08-15 20:45 UTC)
MIT

cpfhub-mcp: Official MCP Server for CPFHub.io

What is CPFHub.io?

Tools

Tool Definition

Quick Start

curl Example

Configuration

Claude Desktop

Cursor

Windsurf

OpenAI Function Calling Example

LangChain Example

Requirements

Links

License

Português

O que é o CPFHub.io?

Ferramentas (Tools)

Definição da Ferramenta

Início Rápido

Exemplo curl

Configuração

Claude Desktop

Cursor

Windsurf

Exemplo com OpenAI Function Calling

Exemplo com LangChain

Requisitos

Links

Licença

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

mcp-brasil

mcp-brasil

Cadastro PF Básico

Receita Federal PF