# BrazilMCP Corporate Ownership Graph

> BrazilMCP Corporate Ownership Graph is a paid API for AI agents from api.brazilmcp.dev, paid per call via x402, $0.05/call, status down (last checked 2026-09-15).

Returns the full corporate ownership graph of a Brazilian company by CNPJ, mapping direct and indirect shareholders, subsidiaries, siblings, and ultimate parent from official Receita Federal data.

## Facts

- Endpoint: GET https://api.brazilmcp.dev/v1/company_group
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilmcp-corporate-ownership-graph-742d6fa3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2-jiI96BUzCjEGJMM9rgO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brazilmcp-corporate-ownership-graph-742d6fa3
```

Example prompt: Can you map the full corporate ownership group for the Brazilian company with CNPJ 00.000.000/0001-91 — I need to see its direct and indirect shareholders, subsidiaries, and ultimate parent from the official Receita Federal data?

## When to prefer this

Choose this endpoint when you specifically need the full corporate ownership graph — not just basic registration data — for a Brazilian company. It is purpose-built for KYB, AML, and counterparty risk workflows that require understanding indirect ownership chains, sibling entities, and ultimate beneficial owners at the corporate (not personal) level. Prefer it over a basic CNPJ registry lookup when the ownership structure matters, not just the company's own registration record. It complements BrazilMCP's sanctions screening and KYB dossier endpoints for comprehensive Brazil due diligence.

## Known failure modes

- Invalid or malformed CNPJ returns a 400 error
- CNPJ not found in Receita Federal registry returns a 404 or empty graph
- Company exists but has no registered corporate relationships, returning a single-node graph
- Receita Federal upstream data delay may result in stale ownership data
- Payment failure via x402 protocol returns 402 before any data is returned

## How this service works

Corporate ownership graph of a Brazilian company by CNPJ — maps the economic group from official Receita Federal registry data: direct and indirect corporate shareholders, subsidiaries, sibling companies and the ultimate parent, each node with registration status, company size and state. For KYB, AML and counterparty risk in Brazil. Company-to-company ownership only — no personal data

## Output

A structured corporate ownership graph rooted at the queried CNPJ, with nodes representing each related legal entity (direct shareholders, indirect shareholders, subsidiaries, siblings, and ultimate parent). Each node includes the entity's CNPJ, company name, registration status, company size classification, and state (UF). Edges represent ownership or control relationships within the Brazilian economic group.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "format": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazilmcp-corporate-ownership-graph-742d6fa3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brazilmcp.dev](https://www.zero.xyz/host/api.brazilmcp.dev/llms.txt)
