kyb-brasil
Brazilian KYB beyond registry checks: CGU sanctions, forced labour, PGFN, IBAMA, signed risk score
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~7,492Tokens (Tool-Definitionen)
~7.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (5.85% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"kyb-brasil": {
"url": "https://kyb-br-agents-dev.marcelfons.workers.dev/mcp"
}
}
}Remote-Endpunkte
https://kyb-br-agents-dev.marcelfons.workers.dev/mcpstreamable-httphttps://kyb-br-agents.marcelfons.workers.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢br_about
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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"service": {
"type": "string"
},
"version": {
"type": "string"
},
"why_this_one": {
"type": "array",
"items": {
"type": "string"
}
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price_usd": {
"type": "number"
},
"http": {
"type": "string"
}
},
"required": [
"name",
"price_usd",
"http"
],
"additionalProperties": {}
}
}
},
"required": [
"service",
"version",
"why_this_one",
"tools"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_check(cnpj)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"legal_name": {
"type": "string"
},
"registration_status": {
"type": "string",
"description": "ATIVA, SUSPENSA, INAPTA, BAIXADA, NULA or UNKNOWN."
},
"opened_at": {
"type": [
"string",
"null"
]
},
"main_activity": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"code",
"description"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"address": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"legal_name",
"registration_status",
"opened_at",
"main_activity",
"address"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_search(query, state, limit)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 3,
"maxLength": 120,
"description": "Company name, legal or trade (e.g. 'Petrobras', 'construtora alfa')."
},
"state": {
"description": "Optional UF to narrow down (e.g. 'SP').",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"limit": {
"description": "Max results, default 10.",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"state": {
"type": [
"string",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj": {
"type": "string"
},
"cnpj_formatted": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"trade_name": {
"type": [
"string",
"null"
]
},
"registration_status": {
"type": "string"
},
"is_headquarters": {
"type": "boolean"
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"required": [
"cnpj",
"cnpj_formatted",
"legal_name",
"trade_name",
"registration_status",
"is_headquarters",
"city",
"state"
],
"additionalProperties": {}
}
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"query",
"state",
"results",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_count(cnae, state, city, opened_after, opened_before, ...)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"cnae": {
"description": "CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).",
"type": "string",
"maxLength": 12
},
"state": {
"description": "UF, e.g. 'SP'.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"city": {
"description": "Municipality name (accents and case ignored).",
"type": "string",
"maxLength": 80
},
"opened_after": {
"description": "Opened on or after (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"opened_before": {
"description": "Opened on or before (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"hq_only": {
"description": "Only headquarters (one row per company).",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"total": {
"type": "number"
},
"pages_of_100": {
"type": "number"
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
}
},
"required": [
"filters",
"total",
"pages_of_100",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_replay(token)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "receipt.replay_token from a paid answer (valid 10 minutes)."
}
},
"required": [
"token"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"generated_at",
"cached",
"receipt"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_sanctions_screen(cnpj)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
},
"clear": {
"type": "boolean",
"description": "True when there is no ACTIVE sanction on the company, its branches or corporate partners."
},
"active_hits": {
"type": "number"
},
"expired_hits": {
"type": "number"
},
"hits": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Each hit: list, sanctioned_entity, sanction_type, dates, active, evidence_url."
},
"screened_entities": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"clear",
"active_hits",
"expired_hits",
"hits",
"screened_entities"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_risk_screen(cnpj)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"company": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sanctions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_debt": {
"anyOf": [
{
"type": "object",
"properties": {
"inscriptions": {
"type": "number"
},
"total_brl": {
"type": "number"
},
"judicial": {
"type": "boolean"
}
},
"required": [
"inscriptions",
"total_brl",
"judicial"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"environmental_embargoes": {
"anyOf": [
{
"type": "object",
"properties": {
"active": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"active",
"total"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"international_sanctions": {
"anyOf": [
{
"type": "object",
"properties": {
"possible_matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"possible_matches"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"fiscal_regularity": {
"type": "object",
"properties": {
"tax_regime": {
"type": [
"string",
"null"
]
},
"federal_debt_on_record": {
"type": [
"boolean",
"null"
]
},
"likely_eligible_for_cnd": {
"type": [
"boolean",
"null"
]
},
"cnd_url": {
"type": "string"
}
},
"required": [
"tax_regime",
"federal_debt_on_record",
"likely_eligible_for_cnd",
"cnd_url"
],
"additionalProperties": {}
},
"economic_group": {
"anyOf": [
{
"type": "object",
"properties": {
"partners_checked": {
"type": "number"
},
"total": {
"type": "number"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"partners_checked",
"total",
"companies"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable)."
},
"risk": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"score": {
"type": "number"
},
"red_flags": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_steps": {
"description": "Recommended actions, most severe first.",
"type": "array",
"items": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false
}
}
},
"required": [
"level",
"score",
"red_flags"
],
"additionalProperties": false
},
"data_quality": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section": {
"type": "string"
},
"reference_date": {
"type": [
"string",
"null"
]
},
"age_days": {
"type": [
"number",
"null"
]
},
"grade": {
"type": "string"
}
},
"required": [
"section",
"reference_date",
"age_days",
"grade"
],
"additionalProperties": false
},
"description": "Per-section data age: fresh, aging, stale, unavailable or unknown."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"cnpj",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached",
"company",
"sanctions",
"federal_debt",
"environmental_embargoes",
"international_sanctions",
"fiscal_regularity",
"economic_group",
"risk",
"data_quality",
"warnings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_dossier(cnpj)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Normalized 14-character CNPJ."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
},
"description": "Source URL and fetch time of each fact."
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"company": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"partners": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"sanctions": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_contracts": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"federal_debt": {
"anyOf": [
{
"type": "object",
"properties": {
"inscriptions": {
"type": "number"
},
"total_brl": {
"type": "number"
},
"judicial": {
"type": "boolean"
}
},
"required": [
"inscriptions",
"total_brl",
"judicial"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "PGFN active federal debt (null = dataset unavailable)."
},
"environmental_embargoes": {
"anyOf": [
{
"type": "object",
"properties": {
"active": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"active",
"total"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "IBAMA embargo terms."
},
"bndes_financing": {
"anyOf": [
{
"type": "object",
"properties": {
"contracts": {
"type": "number"
},
"total_contracted_brl": {
"type": "number"
}
},
"required": [
"contracts",
"total_contracted_brl"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"international_sanctions": {
"anyOf": [
{
"type": "object",
"properties": {
"possible_matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"possible_matches"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "OFAC/UN/EU name-only matches; informational, never scored."
},
"gazette_mentions": {
"anyOf": [
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"recent": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"total",
"recent"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Querido Diário mentions in municipal official gazettes."
},
"fiscal_regularity": {
"type": "object",
"properties": {
"tax_regime": {
"type": [
"string",
"null"
]
},
"federal_debt_on_record": {
"type": [
"boolean",
"null"
]
},
"likely_eligible_for_cnd": {
"type": [
"boolean",
"null"
]
},
"cnd_url": {
"type": "string"
}
},
"required": [
"tax_regime",
"federal_debt_on_record",
"likely_eligible_for_cnd",
"cnd_url"
],
"additionalProperties": {}
},
"economic_group": {
"anyOf": [
{
"type": "object",
"properties": {
"partners_checked": {
"type": "number"
},
"total": {
"type": "number"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"partners_checked",
"total",
"companies"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Other active companies sharing a partner, with their sanction/embargo flags (null = registry unavailable)."
},
"risk": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"score": {
"type": "number"
},
"red_flags": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_steps": {
"description": "Recommended actions, most severe first.",
"type": "array",
"items": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false
}
}
},
"required": [
"level",
"score",
"red_flags"
],
"additionalProperties": false
},
"data_quality": {
"type": "array",
"items": {
"type": "object",
"properties": {
"section": {
"type": "string"
},
"reference_date": {
"type": [
"string",
"null"
]
},
"age_days": {
"type": [
"number",
"null"
]
},
"grade": {
"type": "string"
}
},
"required": [
"section",
"reference_date",
"age_days",
"grade"
],
"additionalProperties": false
},
"description": "Per-section data age: fresh, aging, stale, unavailable or unknown."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"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"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_batch_sanctions(cnpjs)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpjs": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
},
"description": "1 to 10 CNPJs."
}
},
"required": [
"cnpjs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"succeeded": {
"type": "number"
},
"failed": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj_input": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"cnpj_input",
"ok"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
}
},
"required": [
"count",
"succeeded",
"failed",
"results",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_batch_dossier(cnpjs)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnpjs": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 14,
"maxLength": 18,
"description": "Brazilian CNPJ, 14 characters, with or without punctuation (e.g. 00.000.000/0001-91)."
},
"description": "1 to 10 CNPJs."
}
},
"required": [
"cnpjs"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"succeeded": {
"type": "number"
},
"failed": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj_input": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
}
},
"required": [
"cnpj_input",
"ok"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
}
},
"required": [
"count",
"succeeded",
"failed",
"results",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢br_company_list(cnae, state, city, opened_after, opened_before, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"cnae": {
"description": "CNAE code or prefix: '6201-5/00', '6201500', '6201' (class) or '62' (division).",
"type": "string",
"maxLength": 12
},
"state": {
"description": "UF, e.g. 'SP'.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"city": {
"description": "Municipality name (accents and case ignored).",
"type": "string",
"maxLength": 80
},
"opened_after": {
"description": "Opened on or after (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"opened_before": {
"description": "Opened on or before (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"hq_only": {
"description": "Only headquarters (one row per company).",
"type": "boolean"
},
"page": {
"description": "Page of 100, default 1.",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"total": {
"type": "number"
},
"total_pages": {
"type": "number"
},
"next_page": {
"type": [
"number",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cnpj": {
"type": "string"
},
"cnpj_formatted": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"trade_name": {
"type": [
"string",
"null"
]
},
"registration_status": {
"type": "string"
},
"is_headquarters": {
"type": "boolean"
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"required": [
"cnpj",
"cnpj_formatted",
"legal_name",
"trade_name",
"registration_status",
"is_headquarters",
"city",
"state"
],
"additionalProperties": {}
}
},
"reference_month": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": "string"
},
"pt": {
"type": "string"
}
},
"required": [
"en",
"pt"
],
"additionalProperties": false,
"description": "Short summary in English and Portuguese."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"fetched_at": {
"type": "string"
}
},
"required": [
"name",
"url",
"fetched_at"
],
"additionalProperties": {}
}
},
"data_freshness": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"receipt": {
"type": "object",
"properties": {
"replay_token": {
"type": "string"
},
"replay_until": {
"type": "string"
}
},
"required": [
"replay_token",
"replay_until"
],
"additionalProperties": false,
"description": "Re-read this answer free for 10 minutes with br_replay."
},
"attestation": {
"type": "object",
"properties": {
"algorithm": {
"type": "string"
},
"key_id": {
"type": "string"
},
"sha256": {
"type": "string"
},
"signed_at": {
"type": "string"
},
"signature": {
"type": "string"
},
"verify_url": {
"type": "string"
}
},
"required": [
"algorithm",
"key_id",
"sha256",
"signed_at",
"signature",
"verify_url"
],
"additionalProperties": false,
"description": "Ed25519 signature of this answer; verify at verify_url or with the public key at /.well-known/kyb-attestation.json."
}
},
"required": [
"filters",
"page",
"page_size",
"total",
"total_pages",
"next_page",
"results",
"reference_month",
"summary",
"sources",
"data_freshness",
"generated_at",
"cached"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet11 Tools
verifiziertVersion nicht aufgezeichnet11 Tools