Brazil Pix ISPB, COMPE & CVM Financial Institution KYB Auditor (MCP Server + n8n Ready + REST API)

Audits Brazilian banks, payment institutions, and FinTechs against official Central Bank SPI Pix (ISPB) and COMPE directories. Verifies direct vs. indirect settlement participation, operational status, and AML/KYB Risk Scores (0-100).

Engineered by @b2b-quant-apis for scheduled Machine-to-Machine (n8n / Make.com) pipelines, Autonomous AI Agents (Claude Desktop, Cursor IDE, LangChain, CrewAI), and Enterprise Compliance & RevOps stacks.

---

Why Choose b2b-quant-apis/brazil-pix-ispb-cvm-financial-kyb-auditor?

1. Zero-Proxy & Zero-External-Key Architecture: Connects directly to official primary registries and public regulatory endpoints with deterministic input sanitization and automatic retry/backoff.
2. Quantitative Risk & Opportunity Scoring (0–100): Every output record includes a normalized quantitative score and an executive Markdown Dossier ready for RAG vector databases, Slack/Teams alerts, or CRM enrichment.
3. Native Model Context Protocol (MCP) Server: Connect directly to Claude Desktop, Cursor, Windsurf, or any MCP client in 1 click without deploying local infrastructure.
4. Predictable Pay-Per-Event Pricing: You only pay $0.02 USD per successfully processed record (financial-institution-audited). Zero monthly subscription fees.

---

Transparent Pay-Per-Event (PPE) Pricing

Billing Event Name	Event Title	Price per Event (USD)	Categories
financial-institution-audited	Brazil Pix ISPB & SPI Financial Institution Audited	$0.02 USD	AI, BUSINESS, LEAD_GENERATION

Negative Profit Protection: Failed queries, empty responses, or invalid inputs return cleanly without triggering event charges.

---

Input Parameters

Parameter	Type	Required	Default	Description
institutionQuery	string	Yes	"Banco"	Institution name keyword or 8-digit ISPB code (e.g., 'Itau', 'Nu Pagamentos', 'Banco do Brasil', '00000000').
onlyDirectPix	boolean	Optional	false	When enabled, filters only institutions with direct settlement accounts in the Central Bank SPI.
maxResults	integer	Optional	10	Maximum number of audited financial institutions to return (1 to 100).

Example Input JSON

{
  "institutionQuery": "Banco",
  "onlyDirectPix": true,
  "maxResults": 10
}

---

Output Dataset Schema

Each run pushes structured JSON items to the default Apify Dataset with the following fields:

Field Name	Type	Description
ispbCode	string	ISPB Code (8 Digits) — Official Central Bank of Brazil ISPB identifier.
institutionName	string	Legal Institution Name — Full corporate name registered in the SPI.
shortName	string	Short Trading Name — Abbreviated clearing name.
participationModality	string	Pix Participation Modality — Role in the Pix ecosystem.
participationType	string	SPI Settlement Type — Direct (Direta) or Indirect (Indireta) settlement.
operationStartDate	string	Operation Start Date — Official Pix SPI activation timestamp.
kybTrustScore	integer	KYB & Clearing Trust Score (0-100) — Quantitative AML/KYB clearing reliability score (0-100).
markdownKybDossier	string	Markdown Financial KYB Dossier — Executive report for FinTech BaaS, treasury, and AML compliance teams.

Example Output JSON

[
  {
    "ispbCode": "Sample ISPB Code (8 Digits)",
    "institutionName": "Sample Legal Institution Name",
    "shortName": "Sample Short Trading Name",
    "participationModality": "Sample Pix Participation Modality",
    "participationType": "Sample SPI Settlement Type",
    "operationStartDate": "Sample Operation Start Date",
    "kybTrustScore": 92,
    "markdownKybDossier": "Sample Markdown Financial KYB Dossier"
  }
]

---

1-Click MCP Server Integration (Claude Desktop & Cursor IDE)

Add b2b-quant-apis/brazil-pix-ispb-cvm-financial-kyb-auditor as an AI Agent tool in Claude Desktop (claude_desktop_config.json) or Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "brazil-pix-ispb-cvm-financial-kyb-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "b2b-quant-apis/brazil-pix-ispb-cvm-financial-kyb-auditor"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

• Hosted Streamable HTTP MCP URL: https://mcp.apify.com/?actors=b2b-quant-apis/brazil-pix-ispb-cvm-financial-kyb-auditor

---

Automated Daily n8n Workflow Template

Download the pre-built, sanitized n8n workflow template with a daily Schedule Trigger (07:00 AM), HTTP Request node, and CRM/Slack Webhook Router:

• Direct Download (.n8n.json): brazil-pix-ispb-cvm-financial-kyb-auditor.n8n.json
• Enterprise Multi-Actor Super-Pipelines: GitHub Repository jesleytassili-glitch/b2b-quant-mcp-n8n-suite

---

Direct Stateless REST API Call (cURL Synchronous JSON)

Call this Actor synchronously as a standard HTTP POST micro-API and receive the JSON dataset array directly in the HTTP response:

curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-pix-ispb-cvm-financial-kyb-auditor/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"institutionQuery": "Banco", "onlyDirectPix": true, "maxResults": 10}'

---

Frequently Asked Questions (FAQ)

1. Do I need to configure residential proxies or third-party API keys?

No. b2b-quant-apis/brazil-pix-ispb-cvm-financial-kyb-auditor runs out-of-the-box with zero external API keys and zero paid proxy requirements.

2. Can I chain this Actor with other B2B compliance and lead enrichment tools?

Yes. Explore the full 25-Actor B2B Quant & Regulatory Suite at apify.com/b2b-quant-apis or import our 5 Multi-Actor Waterfall Pipelines from GitHub (jesleytassili-glitch/b2b-quant-mcp-n8n-suite).