kyb-brasil

by io.github.celfons

Overview Discussions Admin

Server Details

Brazilian KYB beyond registry checks: CGU sanctions, forced labour, PGFN, IBAMA, signed risk score

Ownership verified

Status: Healthy
Last Tested: 2026-10-12 21:25
Transport: Streamable HTTP · MCP 2025-11-25
URL

TDQS

Score is being calculated.

Available Tools

11 tools

br_about

Read-onlyIdempotent

Inspect

Free. What KYB Brasil is and why to use it over a plain registry check: every tool with price and HTTP route, how x402 payment works, free-tier limits, the attestation key, docs (OpenAPI, llms.txt, skill.md) and sources. Call it first when you do not know the service.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

Output Schema

ParametersJSON Schema

Name	Required	Description
`tools`	Yes
`service`	Yes
`version`	Yes
`why_this_one`	Yes

br_batch_dossier

Read-only

Inspect

Up to 10 CNPJs in one paid call (one payment, a third off): br_company_dossier for each. Per-item errors are reported inline in results[]; the call fails (and is not charged) only when no item succeeds. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description	Default
`cnpjs`	Yes	1 to 10 CNPJs.

Output Schema

ParametersJSON Schema

Name	Required	Description
`count`	Yes
`cached`	Yes
`failed`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`results`	Yes
`sources`	Yes
`summary`	Yes	Short summary in English and Portuguese.
`succeeded`	Yes
`generated_at`	Yes
`data_freshness`	Yes

br_batch_sanctions

Read-only

Inspect

Up to 10 CNPJs in one paid call (one payment, 25% off): br_sanctions_screen for each. Per-item errors are reported inline in results[]; the call fails (and is not charged) only when no item succeeds. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description	Default
`cnpjs`	Yes	1 to 10 CNPJs.

Output Schema

ParametersJSON Schema

Name	Required	Description
`count`	Yes
`cached`	Yes
`failed`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`results`	Yes
`sources`	Yes
`summary`	Yes	Short summary in English and Portuguese.
`succeeded`	Yes
`generated_at`	Yes
`data_freshness`	Yes

br_company_check

Read-only

Inspect

Free. Brazilian company (CNPJ) registration check at the Receita Federal: status (ATIVA/BAIXADA/INAPTA...), legal name, CNAE, size, age, normalized address. Structured JSON plus a summary in English and Portuguese, with sources[] and data_freshness. Rate limited (50/day).

ParametersJSON Schema

Name	Required	Description	Default
`cnpj`	Yes	Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91).

Output Schema

ParametersJSON Schema

Name	Required	Description
`cnpj`	Yes	Normalized 14-character CNPJ.
`cached`	Yes
`address`	Yes
`sources`	Yes	Source URL and fetch time of each fact.
`summary`	Yes	Short summary in English and Portuguese.
`opened_at`	Yes
`legal_name`	Yes
`generated_at`	Yes
`main_activity`	Yes
`data_freshness`	Yes
`registration_status`	Yes	ATIVA, SUSPENSA, INAPTA, BAIXADA, NULA or UNKNOWN.

br_company_count

Read-only

Inspect

Free. How many ACTIVE Brazilian establishments match a prospecting filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), from the Receita Federal monthly registry. Use it to budget pages before paying for br_company_list. Rate limited (50/day).

ParametersJSON Schema

Name	Required	Description
`city`	No	Municipality name (accents and case ignored).
`cnae`	No	CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).
`state`	No	UF, e.g. 'SP'.
`hq_only`	No	Only headquarters (one row per company).
`opened_after`	No	Opened on or after (YYYY-MM-DD).
`opened_before`	No	Opened on or before (YYYY-MM-DD).

Output Schema

ParametersJSON Schema

Name	Required	Description
`total`	Yes
`cached`	Yes
`filters`	Yes
`sources`	Yes
`summary`	Yes	Short summary in English and Portuguese.
`generated_at`	Yes
`pages_of_100`	Yes
`data_freshness`	Yes
`reference_month`	Yes

br_company_dossier

Read-only

Inspect

One-call KYB due diligence, beyond a registry check: Receita Federal registration + ownership (no personal IDs) + economic group + sanctions (CEIS/CNEP/CEPIM/leniency/forced labour) + PGFN debt and fiscal regularity + IBAMA embargoes + court cases (DJEN) + federal contracts + BNDES + OFAC/UN/EU screening + gazettes + 0-100 risk score with explained red flags + per-section data quality, sources[]. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description	Default
`cnpj`	Yes	Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91).

Output Schema

ParametersJSON Schema

Name	Required	Description
`cnpj`	Yes	Normalized 14-character CNPJ.
`risk`	Yes
`cached`	Yes
`company`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`sources`	Yes	Source URL and fetch time of each fact.
`summary`	Yes	Short summary in English and Portuguese.
`partners`	Yes
`warnings`	Yes
`sanctions`	Yes
`attestation`	No	Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.
`data_quality`	Yes	Per-section data age: fresh, aging, stale, unavailable or unknown.
`federal_debt`	Yes	PGFN active federal debt (null = dataset unavailable).
`generated_at`	Yes
`data_freshness`	Yes
`economic_group`	Yes	Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable).
`bndes_financing`	Yes
`gazette_mentions`	Yes	Querido Diário mentions in municipal official gazettes.
`federal_contracts`	Yes
`fiscal_regularity`	Yes
`environmental_embargoes`	Yes	IBAMA embargo terms.
`international_sanctions`	Yes	OFAC/UN/EU name-only matches; informational, never scored.

br_company_list

Read-only

Inspect

Prospecting list: one page of 100 ACTIVE Brazilian establishments matching a filter (CNAE code or prefix, state/UF, city, opening date range, headquarters only), with CNPJ, legal and trade name, city/state, main activity and opening date. Stable paging by CNPJ; total and next_page included. Source: Receita Federal monthly registry; MEI owners' CPFs masked. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description
`city`	No	Municipality name (accents and case ignored).
`cnae`	No	CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).
`page`	No	Page of 100, default 1.
`state`	No	UF, e.g. 'SP'.
`hq_only`	No	Only headquarters (one row per company).
`opened_after`	No	Opened on or after (YYYY-MM-DD).
`opened_before`	No	Opened on or before (YYYY-MM-DD).

Output Schema

ParametersJSON Schema

Name	Required	Description
`page`	Yes
`total`	Yes
`cached`	Yes
`filters`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`results`	Yes
`sources`	Yes
`summary`	Yes	Short summary in English and Portuguese.
`next_page`	Yes
`page_size`	Yes
`attestation`	No	Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.
`total_pages`	Yes
`generated_at`	Yes
`data_freshness`	Yes
`reference_month`	Yes

br_company_search

Read-only

Inspect

Free. Find a Brazilian company's CNPJ by name (legal or trade name, optional state/UF) in the Receita Federal registry of ACTIVE establishments (monthly dump; individual entrepreneurs/MEI not indexed, query those by CNPJ). Returns up to 20 candidates with CNPJ, names, city/state, main activity and opening date. Use the CNPJ with the other tools. Rate limited (50/day).

ParametersJSON Schema

Name	Required	Description
`limit`	No	Max results, default 10.
`query`	Yes	Company name, legal or trade (e.g. 'Petrobras', 'construtora alfa').
`state`	No	Optional UF to narrow down (e.g. 'SP').

Output Schema

ParametersJSON Schema

Name	Required	Description
`query`	Yes
`state`	Yes
`cached`	Yes
`results`	Yes
`sources`	Yes
`summary`	Yes	Short summary in English and Portuguese.
`generated_at`	Yes
`data_freshness`	Yes
`reference_month`	Yes

br_replay

Read-onlyIdempotent

Inspect

Free. Fetch again, without paying, a paid answer from the last 10 minutes using the receipt.replay_token it carried. Use it when the first response was lost (timeout, disconnect) instead of paying twice.

ParametersJSON Schema

Name	Required	Description	Default
`token`	Yes	receipt.replay_token from a paid answer (valid 10 minutes).

Output Schema

ParametersJSON Schema

Name	Required	Description
`cached`	Yes
`receipt`	Yes	Re-read this answer free for 10 minutes with br_replay.
`attestation`	No	Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.
`generated_at`	Yes

br_risk_screen

Read-only

Inspect

Red flags a registry check misses, a third of the dossier price: Receita Federal status + sanctions (CEIS/CNEP/CEPIM/leniency/forced labour) + PGFN debt and fiscal regularity (Simples/MEI, CND hint) + IBAMA embargoes + court cases (DJEN, 12 months) + OFAC/UN/EU screening + economic group (companies sharing partners) + 0-100 risk score + per-section data quality. No contracts, BNDES or gazettes. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description	Default
`cnpj`	Yes	Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91).

Output Schema

ParametersJSON Schema

Name	Required	Description
`cnpj`	Yes	Normalized 14-character CNPJ.
`risk`	Yes
`cached`	Yes
`company`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`sources`	Yes	Source URL and fetch time of each fact.
`summary`	Yes	Short summary in English and Portuguese.
`warnings`	Yes
`sanctions`	Yes
`attestation`	No	Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.
`data_quality`	Yes	Per-section data age: fresh, aging, stale, unavailable or unknown.
`federal_debt`	Yes
`generated_at`	Yes
`data_freshness`	Yes
`economic_group`	Yes	Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable).
`fiscal_regularity`	Yes
`environmental_embargoes`	Yes
`international_sanctions`	Yes

br_sanctions_screen

Read-only

Inspect

Screen a Brazilian CNPJ, all branches of the same company (CNPJ root) and its corporate partners against the official CGU sanction lists: CEIS (debarred), CNEP (anti-corruption penalties), CEPIM (barred non-profits), leniency agreements, plus the Ministry of Labour forced-labour employer list. Each hit has type, body, dates, active flag and an evidence URL. Beyond a plain CEIS/CNEP check. Signed answer (Ed25519 attestation), verifiable at /v1/verify.

ParametersJSON Schema

Name	Required	Description	Default
`cnpj`	Yes	Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91).

Output Schema

ParametersJSON Schema

Name	Required	Description
`cnpj`	Yes	Normalized 14-character CNPJ.
`hits`	Yes	Each hit: list, sanctioned_entity, sanction_type, dates, active, evidence_url.
`clear`	Yes	True when there is no ACTIVE sanction on the company, its branches or corporate partners.
`cached`	Yes
`receipt`	No	Re-read this answer free for 10 minutes with br_replay.
`sources`	Yes	Source URL and fetch time of each fact.
`summary`	Yes	Short summary in English and Portuguese.
`active_hits`	Yes
`attestation`	No	Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.
`expired_hits`	Yes
`generated_at`	Yes
`data_freshness`	Yes
`screened_entities`	Yes

Tool Schema Changelog

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

10 tool updatesOct 12, 2026

Addedbr_about
Addedbr_batch_dossier
Addedbr_batch_sanctions
Addedbr_company_count

Changedbr_company_dossier12 fields changed

addedOutput schema / properties / attestation

Added value: +{
+  "additionalProperties": false,
+  "description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.",
+  "properties": {
+    "algorithm": {
+      "type": "string"
+    },
+    "key_id": {
+      "type": "string"
+    },
+    "sha256": {
+      "type": "string"
+    },
+    "signature": {
+      "type": "string"
+    },
+    "signed_at": {
+      "type": "string"
+    },
+    "verify_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "algorithm",
+    "key_id",
+    "sha256",
+    "signed_at",
+    "signature",
+    "verify_url"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / bndes_financing

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "contracts": {
+          "type": "number"
+        },
+        "total_contracted_brl": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "contracts",
+        "total_contracted_brl"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / data_quality

Added value: +{
+  "description": "Per-section data age: fresh, aging, stale, unavailable or unknown.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "age_days": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "grade": {
+        "type": "string"
+      },
+      "reference_date": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "section": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "section",
+      "reference_date",
+      "age_days",
+      "grade"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / economic_group

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "companies": {
+          "items": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "partners_checked": {
+          "type": "number"
+        },
+        "total": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "partners_checked",
+        "total",
+        "companies"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable)."
+}

addedOutput schema / properties / environmental_embargoes

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "active": {
+          "type": "number"
+        },
+        "total": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "active",
+        "total"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "IBAMA embargo terms."
+}

addedOutput schema / properties / federal_debt

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "inscriptions": {
+          "type": "number"
+        },
+        "judicial": {
+          "type": "boolean"
+        },
+        "total_brl": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "inscriptions",
+        "total_brl",
+        "judicial"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "PGFN active federal debt (null = dataset unavailable)."
+}

addedOutput schema / properties / fiscal_regularity

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "cnd_url": {
+      "type": "string"
+    },
+    "federal_debt_on_record": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "likely_eligible_for_cnd": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "tax_regime": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "tax_regime",
+    "federal_debt_on_record",
+    "likely_eligible_for_cnd",
+    "cnd_url"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / gazette_mentions

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "recent": {
+          "items": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "total": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "total",
+        "recent"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Querido Diário mentions in municipal official gazettes."
+}

addedOutput schema / properties / international_sanctions

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "possible_matches": {
+          "items": {
+            "additionalProperties": {},
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "possible_matches"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "OFAC/UN/EU name-only matches; informational, never scored."
+}

addedOutput schema / properties / receipt

Added value: +{
+  "additionalProperties": false,
+  "description": "Re-read this answer free for 10 minutes with br_replay.",
+  "properties": {
+    "replay_token": {
+      "type": "string"
+    },
+    "replay_until": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "replay_token",
+    "replay_until"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / risk / properties / next_steps

Added value: +{
+  "description": "Recommended actions, most severe first.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "en": {
+        "type": "string"
+      },
+      "pt": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "en",
+      "pt"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "cnpj",
-  "summary",
-  "sources",
-  "data_freshness",
-  "generated_at",
-  "cached",
-  "company",
-  "partners",
-  "sanctions",
-  "federal_contracts",
-  "risk",
-  "warnings"
-]New value: +[
+  "cnpj",
+  "summary",
+  "sources",
+  "data_freshness",
+  "generated_at",
+  "cached",
+  "company",
+  "partners",
+  "sanctions",
+  "federal_contracts",
+  "federal_debt",
+  "environmental_embargoes",
+  "bndes_financing",
+  "international_sanctions",
+  "gazette_mentions",
+  "fiscal_regularity",
+  "economic_group",
+  "risk",
+  "data_quality",
+  "warnings"
+]

Addedbr_company_list
Addedbr_company_search
Addedbr_replay
Addedbr_risk_screen

Changedbr_sanctions_screen2 fields changed

addedOutput schema / properties / attestation

Added value: +{
+  "additionalProperties": false,
+  "description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json.",
+  "properties": {
+    "algorithm": {
+      "type": "string"
+    },
+    "key_id": {
+      "type": "string"
+    },
+    "sha256": {
+      "type": "string"
+    },
+    "signature": {
+      "type": "string"
+    },
+    "signed_at": {
+      "type": "string"
+    },
+    "verify_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "algorithm",
+    "key_id",
+    "sha256",
+    "signed_at",
+    "signature",
+    "verify_url"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / receipt

Added value: +{
+  "additionalProperties": false,
+  "description": "Re-read this answer free for 10 minutes with br_replay.",
+  "properties": {
+    "replay_token": {
+      "type": "string"
+    },
+    "replay_until": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "replay_token",
+    "replay_until"
+  ],
+  "type": "object"
+}

3 tool updatesOct 11, 2026
- First observedbr_company_check
- First observedbr_company_dossier
- First observedbr_sanctions_screen

Publisher details

Operator: Not applicable
Operator website: Not applicable
Vendor relationship: Not available
Documentation: Not available
Trust center: Not available
Restrictions: Not applicable

Related MCP Connectors

Onça — Brazil financial competitive & regulatory intelligenceOAuth
io.github.marcioyoshida
Brazilian financial institutions: entity registry, sourced regulatory signals, cited Q&A
Finance Government Data Legal & Compliance
1
BrazilMCP A
dev.brazilmcp
Brazilian company data (CNPJ): registry lookup, sanctions screening and KYB dossier, paid via x402
Government Data Finance
2
Transparência (CGU)A
io.github.mcp-dir
Brazilian Federal Transparency Portal: sanctions (CEIS, CNEP, CEPIM) and Politically Exposed Persons
Government Data Legal & Compliance
101
kya-brasil
io.github.celfons
Know-your-agent for Brazil: e-CNPJ-signed credentials binding AI agents to companies, KYB-checked
101

Related MCP Servers

Brazilayer MCP Serverofficial
Government Data Finance Open Data
brazilayer
A
license
B
quality
B
maintenance
Enables AI agents to access Brazilian public data including company registry and official sanction lists via MCP tools, with pay-per-call via USDC.
Updated 12 days ago (2026-10-01 11:42 UTC)
47
MIT
mcp-fiscal-brasil
Finance Government Data Open Data
DeHor-Labs
A
license
B
quality
C
maintenance
Connects AI agents to Brazilian tax compliance data (CNPJ, CPF, NFe, SPED, eSocial) and provides tools for due diligence, risk scoring, and tax regime comparison.
Updated 2 days ago (2026-10-11 08:06 UTC)
44
139 PyPI
319
MIT
Transparência (CGU)
Government Data Open Data
mcp-dir
A
license
Not graded
quality
C
maintenance
Enables querying the Brazilian Federal Transparency Portal for sanctions (CEIS, CNEP, CEPIM), politically exposed persons (PEP), and federal expenses received by a CPF/CNPJ, supporting due diligence and compliance.
Updated a month ago (2026-08-30 19:49 UTC)
MIT
Brazilian Sanctions MCP Server
Government Data Legal & Compliance Open Data
williamoliv
A
license
Not graded
quality
D
maintenance
Enables searching and analyzing Brazilian sanctions across multiple registers (CNEP, CEIS, CEPIM, CEAF, Leniency Agreements) via CNPJ/CPF or name for leniency agreements, with tools for status checks, sanctioning authorities, location info, and comprehensive reports.
Updated 4 months ago (2026-06-22 16:07 UTC)
1
MIT

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?

Server Details

TDQS

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Tool Schema Changelog

Publisher details

Related MCP Connectors

Related MCP Servers

Brazilayer MCP Serverofficial

mcp-fiscal-brasil

Transparência (CGU)

Brazilian Sanctions MCP Server

Glama MCP Gateway

Resources