Brazil Central Bank PTAX, Selic, CDI & IPCA Contract Indexer (MCP Server + n8n Ready + REST API)

Fetches official Central Bank of Brazil (BCB SGS & Olinda) macroeconomic series (Selic, CDI, IPCA, IGP-M, PTAX USD/EUR) and calculates automated B2B contract, lease, and treasury monetary adjustments.

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-bcb-ptax-sgs-financial-contract-indexer?

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.015 USD per successfully processed record (contract-index-calculated). Zero monthly subscription fees.

---

Transparent Pay-Per-Event (PPE) Pricing

Billing Event Name	Event Title	Price per Event (USD)	Categories
contract-index-calculated	BCB PTAX, Selic, CDI or IPCA Contract Index Calculated	$0.015 USD	AI, BUSINESS, AUTOMATION

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

---

Input Parameters

Parameter	Type	Required	Default	Description
indicators	string	Yes	"SELIC,IPCA,IGP-M,PTAX_USD"	Comma-separated BCB indicators: SELIC (432), IPCA (433), IGP-M (189), PTAX_USD (1), CDI (12).
contractBaseValueBrl	number	Optional	10000	Principal value in BRL to simulate monetary adjustment against the latest indicator rate.
maxResults	integer	Optional	5	Maximum number of indicator records to return (1 to 20).

Example Input JSON

{
  "indicators": "SELIC,IPCA,IGP-M,PTAX_USD",
  "contractBaseValueBrl": 10000,
  "maxResults": 5
}

---

Output Dataset Schema

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

Field Name	Type	Description
indicatorCode	string	Indicator Code — BCB SGS series code.
indicatorName	string	Indicator Name — Official macroeconomic indicator name.
referenceDate	string	Reference Date — Latest official publication date (DD/MM/YYYY).
latestRateValue	number	Latest Rate / Value — Latest official value or rate published by BCB.
unitType	string	Unit / Periodicity — Rate unit (% p.a., % p.m., BRL/USD).
contractBaseValueBrl	number	Base Contract Value (BRL) — Input contract principal in BRL.
adjustedContractValueBrl	number	Adjusted Contract Value (BRL) — Simulated adjusted value in BRL.
financialImpactScore	integer	Financial Impact Score (0-100) — Quantitative treasury materiality score (0-100).
markdownTreasuryBrief	string	Markdown Treasury & ERP Brief — Executive report for CFOs, ERPs, and legal contract automation.

Example Output JSON

[
  {
    "indicatorCode": "Sample Indicator Code",
    "indicatorName": "Sample Indicator Name",
    "referenceDate": "Sample Reference Date",
    "latestRateValue": 1500.5,
    "unitType": "Sample Unit / Periodicity",
    "contractBaseValueBrl": 1500.5,
    "adjustedContractValueBrl": 1500.5,
    "financialImpactScore": 92,
    "markdownTreasuryBrief": "Sample Markdown Treasury & ERP Brief"
  }
]

---

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

Add b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer as an AI Agent tool in Claude Desktop (claude_desktop_config.json) or Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "brazil-bcb-ptax-sgs-financial-contract-indexer": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

• Hosted Streamable HTTP MCP URL: https://mcp.apify.com/?actors=b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer

---

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-bcb-ptax-sgs-financial-contract-indexer.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-bcb-ptax-sgs-financial-contract-indexer/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"indicators": "SELIC,IPCA,IGP-M,PTAX_USD", "contractBaseValueBrl": 10000, "maxResults": 5}'

---

Frequently Asked Questions (FAQ)

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

No. b2b-quant-apis/brazil-bcb-ptax-sgs-financial-contract-indexer 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).