auxiliar-mcp 0.11.0 → 0.12.0

package/dist/data/capabilities.generated.json

@@ -1463,6 +1463,104 @@
         "page_url": "https://auxiliar.ai/service/better-auth/",
         "external_homepage": "https://better-auth.com"
     },
+    {
+        "id": "brasilapi-cnpj",
+        "element_type": "data",
+        "name": "BrasilAPI: CNPJ lookup",
+        "description": "Free public CNPJ lookup at https://brasilapi.com.br/api/cnpj/v1/{cnpj} — no auth, no token, drop-in HTTP GET. Returns razao_social, nome_fantasia, CNAE fiscal + secondary CNAEs, opção pelo Simples + MEI, situação cadastral, full address, sócios. Data from Receita Federal open data dumps via MinhaReceita.",
+        "jtbd_tags": [
+            "cnpj-enrichment",
+            "brazilian-company-lookup",
+            "cnae-lookup",
+            "regime-tributario-lookup",
+            "bookkeeping-enrichment",
+            "supplier-registry-enrichment",
+            "kyc-lookup"
+        ],
+        "aliases_search": [
+            "BrasilAPI",
+            "BrasilAPI CNPJ",
+            "CNPJ lookup",
+            "CNPJ free API",
+            "razao social lookup",
+            "CNAE lookup",
+            "Simples Nacional lookup",
+            "regime tributário",
+            "bookkeeping CNPJ",
+            "supplier enrichment Brazil",
+            "Brazilian public data API"
+        ],
+        "categories": [
+            "public-data",
+            "brazilian-government",
+            "identifiers",
+            "cnpj-enrichment"
+        ],
+        "works_with": [],
+        "fit_by_agent": {
+            "claude-code": true,
+            "claude-desktop": true,
+            "cursor": true,
+            "openclaw": true
+        },
+        "evals": [],
+        "cost": {
+            "type": "free",
+            "free_tier": "Unlimited from Vercel CDN; reasonable rate limits per IP (BrasilAPI hosts; no published cap).",
+            "hidden_costs": [
+                "Hosted on Vercel — depends on third-party uptime; no SLA.",
+                "Data freshness depends on MinhaReceita dump cadence (typically monthly); not real-time.",
+                "Heavy usage may trigger Vercel-level throttling — reasonable batches recommended."
+            ],
+            "cost_per_unit": {}
+        },
+        "pricing_tiers": [],
+        "compliance": [],
+        "risks": [
+            {
+                "severity": "low",
+                "category": "operational",
+                "description": "Data freshness lags the Receita Federal source by up to ~30 days because BrasilAPI reads from MinhaReceita open data dumps. For real-time situação cadastral changes, pair with a real-time source (cnpja-cnpj paid tier or direct gov.br Conecta)."
+            },
+            {
+                "severity": "low",
+                "category": "supply_chain",
+                "description": "BrasilAPI is community-maintained on Vercel. No SLA, no guaranteed uptime. Production workflows should cache responses and have a fallback (mcp-gov-cnpj-fetch or cnpj-ws)."
+            }
+        ],
+        "deps": {
+            "requires": [],
+            "composes_with": [
+                "auxiliar-nfs-e",
+                "nfs-e-parser",
+                "cnpja-cnpj",
+                "cnpj-ws",
+                "mcp-gov-cnpj-fetch"
+            ],
+            "conflicts": [],
+            "minimum_runtime": "Any HTTP client"
+        },
+        "install": {
+            "primary": {
+                "install_command": "curl -s \"https://brasilapi.com.br/api/cnpj/v1/CNPJ_DIGITS_ONLY\"",
+                "config_snippet": "# Example: 14 digits, no formatting\ncurl -s \"https://brasilapi.com.br/api/cnpj/v1/00000000000191\" | jq .\n# Returns:\n# {\n#   \"razao_social\": \"BANCO DO BRASIL SA\",\n#   \"nome_fantasia\": \"...\",\n#   \"cnae_fiscal\": 6422100,\n#   \"cnae_fiscal_descricao\": \"Bancos múltiplos, com carteira comercial\",\n#   \"cnaes_secundarios\": [...],\n#   \"opcao_pelo_simples\": false,\n#   \"opcao_pelo_mei\": false,\n#   \"descricao_situacao_cadastral\": \"ATIVA\",\n#   \"logradouro\": \"...\", \"municipio\": \"...\", \"uf\": \"...\",\n#   \"qsa\": [...]   # sócios\n# }\n",
+                "setup_url": "https://brasilapi.com.br/docs#tag/CNPJ",
+                "estimated_minutes": 1
+            },
+            "by_agent": {},
+            "by_framework": {}
+        },
+        "last_verified": "2026-04-27",
+        "verification_method": "vendor-docs-2026-04-27",
+        "alternatives_considered": [],
+        "compared_to": [],
+        "choose_if": "You want a free, drop-in, no-auth CNPJ lookup with comprehensive fields (CNAE, Simples, address, partners) — ideal for agent-driven bookkeeping enrichment after NFS-e extraction.",
+        "avoid_if": "You need real-time situação cadastral (BrasilAPI lags by ~30 days from the open data dump cadence) or contractually-backed SLA (use cnpja-cnpj paid or direct gov.br Conecta).",
+        "page_url": "https://auxiliar.ai/data/brasilapi-cnpj/",
+        "external_homepage": "https://brasilapi.com.br",
+        "repository": "https://github.com/BrasilAPI/BrasilAPI",
+        "license": "MIT (BrasilAPI code; underlying data from Receita Federal open dump)"
+    },
     {
         "id": "bullmq",
         "element_type": "cloud_service",
@@ -2197,6 +2295,303 @@
         "page_url": "https://auxiliar.ai/service/cloudinary/",
         "external_homepage": "https://cloudinary.com"
     },
+    {
+        "id": "cnpj-enrichment-mcp",
+        "element_type": "task_template",
+        "name": "CNPJ enrichment for Brazilian bookkeeping agents — what to install, ranked",
+        "description": "Ranked CNPJ enrichment sources for AI agents doing Brazilian bookkeeping. After extracting CNPJs from NFS-e invoices (see /solve/nfs-e-extraction/), agents need to enrich each CNPJ with razão social, CNAE, regime tributário (Simples Nacional flag), full address, and partners. BrasilAPI tops the ranking — free, no auth, drop-in URL.",
+        "jtbd_tags": [
+            "cnpj-enrichment",
+            "brazilian-company-lookup",
+            "cnae-lookup",
+            "regime-tributario-lookup",
+            "bookkeeping-enrichment",
+            "supplier-registry-enrichment"
+        ],
+        "aliases_search": [
+            "CNPJ enrichment",
+            "CNPJ lookup",
+            "CNPJ to CNAE",
+            "regime tributário lookup",
+            "Simples Nacional lookup",
+            "razao social lookup",
+            "bookkeeping CNPJ",
+            "supplier enrichment Brazil",
+            "CNPJ MCP",
+            "Brazilian company API",
+            "CNPJ → CNAE",
+            "CNPJ → regime tributário"
+        ],
+        "categories": [
+            "cnpj-enrichment",
+            "brazilian-bookkeeping",
+            "public-data",
+            "agent-tools",
+            "task-template"
+        ],
+        "works_with": [
+            "claude-code",
+            "claude-desktop",
+            "cursor",
+            "openclaw"
+        ],
+        "fit_by_agent": {
+            "claude-code": true,
+            "claude-desktop": true,
+            "cursor": true,
+            "openclaw": true
+        },
+        "evals": [
+            {
+                "method_id": "auxiliar-cnpj-enrichment-documented-characteristics-v1",
+                "score": 7,
+                "score_breakdown": {
+                    "candidates_ranked": 5,
+                    "free_tier_accessibility_top_pick": 10,
+                    "field_coverage_top_pick": 9,
+                    "regime_tributario_free_tier": 8,
+                    "pending_corpus_run": 0
+                },
+                "corpus_id": "auxiliar-cnpj-enrichment-corpus-v1-pending",
+                "last_run": "2026-04-27",
+                "candidates_outranked": 5
+            }
+        ],
+        "cost": {
+            "type": "free",
+            "free_tier": "Unlimited (the /solve/ page itself is free; underlying tools have free tiers ranging from no-cap to 3 req/min)",
+            "hidden_costs": [],
+            "cost_per_unit": {}
+        },
+        "pricing_tiers": [],
+        "compliance": [],
+        "risks": [],
+        "deps": {
+            "requires": [],
+            "composes_with": [
+                "brasilapi-cnpj",
+                "cnpja-cnpj",
+                "cnpj-ws",
+                "receitaws-cnpj",
+                "mcp-gov-cnpj-fetch",
+                "auxiliar-nfs-e",
+                "nfs-e-parser",
+                "auxiliar-mcp"
+            ],
+            "conflicts": []
+        },
+        "last_verified": "2026-04-27",
+        "verification_method": "auxiliar-cnpj-enrichment-documented-characteristics-v1",
+        "alternatives_considered": [
+            {
+                "name": "Direct gov.br Conecta CNPJ API",
+                "dropped_because": "Official federal API (gov.br/conecta/catalogo/apis/consulta-cnpj) but requires OAuth + government registration that's hostile to drop-in agent usage. Use when the workflow already has a regulated gov.br integration."
+            },
+            {
+                "name": "Speedio",
+                "dropped_because": "Free tier requires email registration; B2B sales-focused with employee-count and revenue-range fields outside the bookkeeping pipeline's CNAE / regime tributário need. Useful for sales enrichment, not for renatoag's bookkeeping use case."
+            },
+            {
+                "name": "Receita Federal scraping (HTML form)",
+                "dropped_because": "The original anti-bot blocker that surfaced this whole /solve/ task — public Receita Federal CNPJ pages are behind anti-bot protection that defeats most scrapers."
+            }
+        ],
+        "compared_to": [],
+        "choose_if": "Your agent extracts CNPJs from Brazilian invoices and needs to enrich each with CNAE, regime tributário, and supplier metadata — for bookkeeping batches, accountant handoff, or tax reconciliation.",
+        "avoid_if": "You need real-time situação cadastral for fraud detection or KYC under regulatory mandate — paid CNPJá real-time is the right call there, not a /solve/ ranking optimized for free-tier agent-friendliness.",
+        "page_url": "https://auxiliar.ai/solve/cnpj-enrichment-mcp/"
+    },
+    {
+        "id": "cnpj-ws",
+        "element_type": "data",
+        "name": "CNPJ.ws: free + commercial CNPJ lookup",
+        "description": "Brazilian CNPJ lookup with free 3 req/min public tier (publica.cnpj.ws) and paid 2000 req/min commercial tier. Sources from Receita Federal + Sintegra + Suframa — deeper field coverage than peers (Inscrições Estaduais, branches/filiais, sócios, MEI/Simples flags, full address). Best when bookkeeping needs state registrations.",
+        "jtbd_tags": [
+            "cnpj-enrichment",
+            "brazilian-company-lookup",
+            "cnae-lookup",
+            "regime-tributario-lookup",
+            "bookkeeping-enrichment",
+            "supplier-registry-enrichment",
+            "inscricao-estadual-lookup",
+            "kyc-lookup"
+        ],
+        "aliases_search": [
+            "CNPJ.ws",
+            "CNPJ ws",
+            "Sintegra lookup",
+            "Suframa lookup",
+            "inscrição estadual",
+            "branches CNPJ",
+            "filiais CNPJ",
+            "sócios CNPJ",
+            "MEI lookup",
+            "Simples Nacional lookup",
+            "bookkeeping CNPJ"
+        ],
+        "categories": [
+            "public-data",
+            "brazilian-government",
+            "identifiers",
+            "cnpj-enrichment"
+        ],
+        "works_with": [],
+        "fit_by_agent": {
+            "claude-code": true,
+            "claude-desktop": true,
+            "cursor": true,
+            "openclaw": true
+        },
+        "evals": [],
+        "cost": {
+            "type": "freemium",
+            "free_tier": "3 requests/minute on publica.cnpj.ws — no auth required.",
+            "paid_starts": "Commercial tier (comercial.cnpj.ws): 2000 req/min, falls to 4 req/min after monthly cap. Contact vendor for current pricing.",
+            "hidden_costs": [
+                "Free tier 3 req/min cap blocks bulk batch enrichment — same constraint as ReceitaWS.",
+                "Paid tier monthly query cap drops throughput to 4 req/min once exhausted."
+            ],
+            "cost_per_unit": {}
+        },
+        "pricing_tiers": [],
+        "compliance": [],
+        "risks": [
+            {
+                "severity": "low",
+                "category": "pricing_unpredictability",
+                "description": "Paid-tier monthly cap drops throughput by 500x (2000 → 4 req/min) when exhausted. Plan for predictable monthly volume or build retry-with-backoff into bulk workflows."
+            },
+            {
+                "severity": "low",
+                "category": "operational",
+                "description": "Sintegra and Suframa data freshness depends on each state's reporting cadence — not all states report at the same interval, so Inscrições Estaduais may be stale for fast-moving registrations."
+            }
+        ],
+        "deps": {
+            "requires": [],
+            "composes_with": [
+                "auxiliar-nfs-e",
+                "nfs-e-parser",
+                "brasilapi-cnpj",
+                "cnpja-cnpj"
+            ],
+            "conflicts": [],
+            "minimum_runtime": "Any HTTP client"
+        },
+        "install": {
+            "primary": {
+                "install_command": "curl -s \"https://publica.cnpj.ws/cnpj/CNPJ_DIGITS_ONLY\"",
+                "config_snippet": "# Free tier (3 req/min):\ncurl -s \"https://publica.cnpj.ws/cnpj/00000000000191\"\n# Returns nested object with razao_social, atividade_principal (CNAE),\n# estabelecimento (full address + filiais), socios, simples, simei,\n# inscricoes_estaduais (per state).\n#\n# Commercial tier (with token for higher throughput):\ncurl -s -H \"Authorization: Bearer YOUR_TOKEN\" \"https://comercial.cnpj.ws/cnpj/00000000000191\"\n",
+                "setup_url": "https://www.cnpj.ws",
+                "estimated_minutes": 2
+            },
+            "by_agent": {},
+            "by_framework": {}
+        },
+        "last_verified": "2026-04-27",
+        "verification_method": "vendor-docs-2026-04-27",
+        "alternatives_considered": [],
+        "compared_to": [],
+        "choose_if": "Your bookkeeping pipeline needs more than CNAE + situação — specifically Inscrições Estaduais (Sintegra), Suframa, branch/filial details, or full sócio list with participation percentages.",
+        "avoid_if": "You only need basic CNAE + Simples flag (BrasilAPI is simpler) or you need real-time data not bound by state-reporting cadence.",
+        "page_url": "https://auxiliar.ai/data/cnpj-ws/",
+        "external_homepage": "https://www.cnpj.ws",
+        "license": "Proprietary (vendor-managed)"
+    },
+    {
+        "id": "cnpja-cnpj",
+        "element_type": "data",
+        "name": "CNPJá: CNPJ lookup (free cached + paid real-time)",
+        "description": "Brazilian CNPJ lookup with two tiers: open.cnpja.com (free, cached daily, no auth) and api.cnpja.com (paid, real-time against Receita Federal, token auth, higher rate limits). Distinguishing feature versus BrasilAPI / CNPJ.ws is the paid real-time tier — situação cadastral changes hit within minutes, not the ~30-day data-dump lag.",
+        "jtbd_tags": [
+            "cnpj-enrichment",
+            "brazilian-company-lookup",
+            "cnae-lookup",
+            "regime-tributario-lookup",
+            "bookkeeping-enrichment",
+            "supplier-registry-enrichment",
+            "kyc-lookup",
+            "real-time-cnpj-status"
+        ],
+        "aliases_search": [
+            "CNPJá",
+            "cnpja",
+            "CNPJa CNPJ",
+            "real-time CNPJ",
+            "situação cadastral real-time",
+            "CNPJ KYC",
+            "CNPJ enrichment paid",
+            "bookkeeping CNPJ"
+        ],
+        "categories": [
+            "public-data",
+            "brazilian-government",
+            "identifiers",
+            "cnpj-enrichment"
+        ],
+        "works_with": [],
+        "fit_by_agent": {
+            "claude-code": true,
+            "claude-desktop": true,
+            "cursor": true,
+            "openclaw": true
+        },
+        "evals": [],
+        "cost": {
+            "type": "freemium",
+            "free_tier": "open.cnpja.com — no auth, cached daily; reasonable rate limits per IP.",
+            "paid_starts": "api.cnpja.com paid plans (pricing on vendor site; tier-based, token auth, real-time).",
+            "hidden_costs": [
+                "Free tier (open.cnpja.com) is cached daily — not real-time. Plan accordingly when situação cadastral matters.",
+                "Paid tier billing model varies (per-call vs monthly subscription) — verify before scaling."
+            ],
+            "cost_per_unit": {}
+        },
+        "pricing_tiers": [],
+        "compliance": [],
+        "risks": [
+            {
+                "severity": "low",
+                "category": "pricing_unpredictability",
+                "description": "Paid tier scales with volume; per-call costs add up at high enrichment volumes. Cache aggressively when situação cadastral doesn't need real-time freshness."
+            },
+            {
+                "severity": "low",
+                "category": "vendor_lockin",
+                "description": "Paid-tier response shape may differ from free-tier; build a normalization layer so callers don't need to change between free and paid."
+            }
+        ],
+        "deps": {
+            "requires": [],
+            "composes_with": [
+                "auxiliar-nfs-e",
+                "nfs-e-parser",
+                "brasilapi-cnpj",
+                "cnpj-ws"
+            ],
+            "conflicts": [],
+            "minimum_runtime": "Any HTTP client"
+        },
+        "install": {
+            "primary": {
+                "install_command": "curl -s \"https://open.cnpja.com/office/CNPJ_DIGITS_ONLY\"",
+                "config_snippet": "# Free cached endpoint (open.cnpja.com — no auth):\ncurl -s \"https://open.cnpja.com/office/00000000000191\"\n# Returns office object with company name, registrations\n# (Receita + Inscrições Estaduais), address, atividade_principal (CNAE),\n# sócios, simples, situação cadastral.\n#\n# Paid real-time endpoint (api.cnpja.com — token in Authorization header):\ncurl -s -H \"Authorization: Bearer YOUR_TOKEN\" \"https://api.cnpja.com/office/00000000000191\"\n",
+                "setup_url": "https://cnpja.com/api",
+                "estimated_minutes": 2
+            },
+            "by_agent": {},
+            "by_framework": {}
+        },
+        "last_verified": "2026-04-27",
+        "verification_method": "vendor-docs-2026-04-27",
+        "alternatives_considered": [],
+        "compared_to": [],
+        "choose_if": "You need real-time situação cadastral changes (KYC, regulated workflows, fraud-detection pipelines) and the ~30-day BrasilAPI / CNPJ.ws data-dump lag isn't acceptable. Free cached tier is also a good drop-in if real-time isn't required.",
+        "avoid_if": "Daily-fresh data is good enough (BrasilAPI is simpler and free-without-cap) or you're budget-constrained — paid real-time scales per-call.",
+        "page_url": "https://auxiliar.ai/data/cnpja-cnpj/",
+        "external_homepage": "https://cnpja.com",
+        "license": "Proprietary (vendor-managed)"
+    },
     {
         "id": "contentful",
         "element_type": "cloud_service",
@@ -4180,7 +4575,10 @@
             "brazilian-company-lookup",
             "receita-federal",
             "bookkeeping-enrichment",
-            "kyc-lookup"
+            "kyc-lookup",
+            "cnae-lookup",
+            "regime-tributario-lookup",
+            "supplier-registry-enrichment"
         ],
         "aliases_search": [
             "CNPJ lookup",
@@ -4189,7 +4587,12 @@
             "Brazilian company lookup",
             "razao social lookup",
             "CNAE lookup",
-            "empresa Receita"
+            "empresa Receita",
+            "regime tributário",
+            "Simples Nacional lookup",
+            "CNAE fiscal",
+            "supplier enrichment Brazil",
+            "bookkeeping CNPJ"
         ],
         "categories": [
             "public-data",
@@ -6585,6 +6988,97 @@
         "page_url": "https://auxiliar.ai/service/railway/",
         "external_homepage": "https://railway.com"
     },
+    {
+        "id": "receitaws-cnpj",
+        "element_type": "data",
+        "name": "ReceitaWS: CNPJ lookup",
+        "description": "Long-running Brazilian CNPJ lookup API at https://receitaws.com.br/v1/cnpj/{cnpj}. Free public tier rate-limited to 3 req/min; paid premium tier with token unlocks higher throughput. Returns razao_social, atividade_principal (CNAE), atividades secundárias, situação, address. Simples Nacional flag is a paid-tier field.",
+        "jtbd_tags": [
+            "cnpj-enrichment",
+            "brazilian-company-lookup",
+            "cnae-lookup",
+            "bookkeeping-enrichment",
+            "supplier-registry-enrichment",
+            "kyc-lookup"
+        ],
+        "aliases_search": [
+            "ReceitaWS",
+            "Receita WS",
+            "CNPJ lookup API",
+            "razao social lookup",
+            "CNAE lookup",
+            "atividade principal",
+            "bookkeeping CNPJ"
+        ],
+        "categories": [
+            "public-data",
+            "brazilian-government",
+            "identifiers",
+            "cnpj-enrichment"
+        ],
+        "works_with": [],
+        "fit_by_agent": {
+            "claude-code": true,
+            "claude-desktop": true,
+            "cursor": true,
+            "openclaw": true
+        },
+        "evals": [],
+        "cost": {
+            "type": "freemium",
+            "free_tier": "3 requests per minute — public endpoint, no token required.",
+            "paid_starts": "Premium tier with token (token-based pricing not publicly listed; contact ReceitaWS).",
+            "hidden_costs": [
+                "3 req/min cap on free tier blocks any bulk enrichment workflow — practical only for ad-hoc lookups.",
+                "Simples Nacional flag is a paid-tier field — free tier returns it as null."
+            ],
+            "cost_per_unit": {}
+        },
+        "pricing_tiers": [],
+        "compliance": [],
+        "risks": [
+            {
+                "severity": "medium",
+                "category": "pricing_unpredictability",
+                "description": "Free-tier 3 req/min is hard-rate-limited; bursting agents will get 429s. For any bookkeeping workflow with >3 invoices/min, plan to use paid tier OR fall back to BrasilAPI (no rate limit) OR batch with explicit retry-with-backoff."
+            },
+            {
+                "severity": "low",
+                "category": "operational",
+                "description": "Single endpoint, single vendor. No SLA published for free tier."
+            }
+        ],
+        "deps": {
+            "requires": [],
+            "composes_with": [
+                "auxiliar-nfs-e",
+                "nfs-e-parser",
+                "brasilapi-cnpj",
+                "cnpj-ws"
+            ],
+            "conflicts": [],
+            "minimum_runtime": "Any HTTP client"
+        },
+        "install": {
+            "primary": {
+                "install_command": "curl -s \"https://receitaws.com.br/v1/cnpj/CNPJ_DIGITS_ONLY\"",
+                "config_snippet": "# Free public tier, 3 req/min cap:\ncurl -s \"https://receitaws.com.br/v1/cnpj/00000000000191\"\n# Returns:\n# {\n#   \"status\": \"OK\",\n#   \"nome\": \"BANCO DO BRASIL SA\",\n#   \"fantasia\": \"...\",\n#   \"atividade_principal\": [{\"code\": \"64.22-1-00\", \"text\": \"Bancos múltiplos...\"}],\n#   \"atividades_secundarias\": [...],\n#   \"logradouro\": \"...\", \"municipio\": \"...\", \"uf\": \"...\",\n#   \"situacao\": \"ATIVA\",\n#   \"simples\": null   # paid-tier field\n# }\n#\n# Paid premium tier — pass token in Authorization header:\ncurl -s -H \"Authorization: Bearer YOUR_TOKEN\" \"https://receitaws.com.br/v1/cnpj/00000000000191\"\n",
+                "setup_url": "https://receitaws.com.br",
+                "estimated_minutes": 1
+            },
+            "by_agent": {},
+            "by_framework": {}
+        },
+        "last_verified": "2026-04-27",
+        "verification_method": "vendor-docs-2026-04-27",
+        "alternatives_considered": [],
+        "compared_to": [],
+        "choose_if": "You're doing ad-hoc CNPJ lookups (≤3 per minute) and want the simplest possible drop-in API with a long, stable history.",
+        "avoid_if": "You need bulk enrichment (>3 req/min on free tier hits 429), Simples Nacional flag on free tier (paid-only field), or modern field shapes (BrasilAPI returns richer data).",
+        "page_url": "https://auxiliar.ai/data/receitaws-cnpj/",
+        "external_homepage": "https://receitaws.com.br",
+        "license": "Proprietary (vendor-managed)"
+    },
     {
         "id": "redis-cloud",
         "element_type": "cloud_service",

package/dist/data/solve.js

@@ -231,4 +231,128 @@ export const solveTasks = {
             openclaw: { "auxiliar-nfs-e-with-surya": true, "auxiliar-nfs-e-with-google-doc-ai": true, "auxiliar-nfs-e-with-tesseract": true },
         },
     },
+    "cnpj-enrichment-mcp": {
+        slug: "cnpj-enrichment-mcp",
+        title: "CNPJ enrichment for Brazilian bookkeeping agents — what to install, ranked",
+        url: "https://auxiliar.ai/solve/cnpj-enrichment-mcp/",
+        last_verified: "2026-04-27",
+        categories: ["cnpj-enrichment", "brazilian-bookkeeping", "public-data", "agent-tools"],
+        works_with: ["claude-code", "claude-desktop", "cursor", "openclaw"],
+        alternatives: ["brasilapi-cnpj", "cnpja-cnpj", "cnpj-ws", "receitaws-cnpj", "mcp-gov-cnpj-fetch"],
+        eval_method: "auxiliar-cnpj-enrichment-documented-characteristics-v1 (5 candidates ranked by free-tier accessibility + field coverage; field-accuracy corpus eval is Phase-2 follow-up)",
+        answer: "When your Claude Code / OpenClaw agent has extracted CNPJs from NFS-e invoices and needs to enrich each one with razão social, CNAE, regime tributário (Simples Nacional flag), full address, partners, and supplier metadata — for bookkeeping batches, accountant handoff, or tax reconciliation — install BrasilAPI's free public endpoint: `curl https://brasilapi.com.br/api/cnpj/v1/<cnpj>`. Free, no auth, no token, drop-in URL; returns CNAE fiscal + secondary CNAEs, opção pelo Simples + MEI, situação cadastral, full address, sócios — sourced from Receita Federal open data dumps via MinhaReceita. For real-time situação cadastral, use CNPJá's paid api.cnpja.com tier. For Inscrições Estaduais (Sintegra) + branches, use CNPJ.ws.",
+        candidates: [
+            {
+                slug: "brasilapi-cnpj",
+                name: "BrasilAPI CNPJ",
+                rank: 1,
+                install: 'curl -s "https://brasilapi.com.br/api/cnpj/v1/CNPJ_DIGITS_ONLY"',
+                scorecard: {
+                    install_friction: 1,
+                    cost_per_10_docs_usd: 0,
+                },
+                notes: "Free, no auth, no token. Drop-in HTTP GET. Returns CNAE primary + secondary, Simples + MEI flags, full address, sócios, situação cadastral. Data sourced from Receita Federal open dumps via MinhaReceita (~30-day lag). Hosted on Vercel CDN. The agent-friendliest default.",
+                license: "MIT (BrasilAPI code; underlying data from Receita Federal open dump)",
+            },
+            {
+                slug: "cnpja-cnpj",
+                name: "CNPJá (free cached + paid real-time)",
+                rank: 2,
+                install: 'curl -s "https://open.cnpja.com/office/CNPJ_DIGITS_ONLY"',
+                scorecard: {
+                    install_friction: 2,
+                    cost_per_10_docs_usd: 0,
+                },
+                notes: "Two tiers: open.cnpja.com (free, cached daily, no auth) and api.cnpja.com (paid, real-time against Receita Federal, token auth). Distinguishing feature is the paid real-time tier — situação cadastral changes hit within minutes. Pick when KYC/fraud freshness matters.",
+                license: "Proprietary",
+            },
+            {
+                slug: "cnpj-ws",
+                name: "CNPJ.ws (free 3 req/min + paid commercial)",
+                rank: 3,
+                install: 'curl -s "https://publica.cnpj.ws/cnpj/CNPJ_DIGITS_ONLY"',
+                scorecard: {
+                    install_friction: 2,
+                    cost_per_10_docs_usd: 0,
+                },
+                notes: "Free tier 3 req/min on publica.cnpj.ws; paid commercial.cnpj.ws at 2000 req/min. Sources from Receita Federal + Sintegra + Suframa — deeper field coverage than peers (Inscrições Estaduais, branches/filiais, sócios with participation %).",
+                license: "Proprietary",
+            },
+            {
+                slug: "receitaws-cnpj",
+                name: "ReceitaWS",
+                rank: 4,
+                install: 'curl -s "https://receitaws.com.br/v1/cnpj/CNPJ_DIGITS_ONLY"',
+                scorecard: {
+                    install_friction: 2,
+                    cost_per_10_docs_usd: 0,
+                },
+                notes: "Long-running canonical Brazilian CNPJ API. Free 3 req/min cap; paid premium tier with token unlocks higher throughput. Simples Nacional flag is a paid-tier-only field — the free response returns simples: null. Simplest possible drop-in shape but slow on free tier.",
+                license: "Proprietary",
+            },
+            {
+                slug: "mcp-gov-cnpj-fetch",
+                name: "mcp-gov-cnpj-fetch",
+                rank: 5,
+                install: "claude mcp add mcp-gov npx mcp-gov",
+                scorecard: {
+                    install_friction: 3,
+                    cost_per_10_docs_usd: 0,
+                },
+                notes: "MCP-routed wrapper for in-loop agent calls. Use when the agent prefers tool-call shape over HTTP, or when chaining mcp-gov for other public-data lookups (CEP, CNAE description, RAIS) in the same session.",
+                license: "Per mcp-gov upstream",
+            },
+        ],
+        corpus_summary: "Documented vendor characteristics — free-tier accessibility, field coverage, real-time vs cached freshness, agent-friendliness — verified via direct curl tests against well-known CNPJs (Banco do Brasil 00.000.000/0001-91 etc.) on 2026-04-27. A 5–10 CNPJ field-accuracy corpus eval is Phase-2 follow-up tracked in backlog.md.",
+        alternatives_considered: [
+            {
+                name: "Direct gov.br Conecta CNPJ API",
+                dropped_because: "Official federal API (gov.br/conecta/catalogo/apis/consulta-cnpj) but requires OAuth + government registration that's hostile to drop-in agent usage. Use when the workflow already has a regulated gov.br integration.",
+            },
+            {
+                name: "Speedio",
+                dropped_because: "Free tier requires email registration; B2B sales-focused with employee-count and revenue-range fields outside the bookkeeping pipeline's CNAE / regime tributário need. Useful for sales enrichment, not for bookkeeping.",
+            },
+            {
+                name: "Receita Federal HTML scraping",
+                dropped_because: "The original anti-bot blocker that surfaced this whole /solve/ task — public Receita Federal CNPJ pages are behind anti-bot protection that defeats most scrapers.",
+            },
+            {
+                name: "Serasa / Quod commercial enrichment",
+                dropped_because: "Enterprise-grade with KYC + fraud signals, but contract-only, no agent-friendly drop-in API; out of scope for free-tier-first agent workflows.",
+            },
+        ],
+        faq: [
+            {
+                q: "Does BrasilAPI return regime tributário (Simples Nacional flag) on the free tier?",
+                a: "Yes. BrasilAPI's CNPJ response includes opcao_pelo_simples: bool and opcao_pelo_mei: bool directly in the free response. ReceitaWS gates this field behind the paid tier — the free response returns simples: null. CNPJ.ws and CNPJá return Simples + MEI flags on their free tiers as well.",
+            },
+            {
+                q: "When does the ~30-day data-dump lag actually matter?",
+                a: "Three cases. (1) Fraud detection — a CNPJ that became INAPTA or BAIXADA last week needs real-time to catch. (2) KYC at supplier-onboarding time — same reason. (3) Tax compliance audits where the auditor's snapshot disagrees with your enriched data. For routine bookkeeping enrichment after the fact, the lag is fine.",
+            },
+            {
+                q: "How do I handle 429 rate-limit errors on the free tiers?",
+                a: "Two patterns. (1) Exponential backoff with Retry-After header respected. (2) Failover to a different source — BrasilAPI ↔ CNPJá open ↔ CNPJ.ws publica are roughly interchangeable for the basic CNAE + Simples + address fields. Code your enrichment loop to try BrasilAPI first, fall through to CNPJá open on 429, fall through to CNPJ.ws publica with a 20-second wait.",
+            },
+            {
+                q: "Does this work alongside auxiliar-nfs-e + Surya for a full bookkeeping pipeline?",
+                a: "Yes — that's the explicit composition. Pipeline: (1) Surya OCRs the NFS-e PDF to text. (2) auxiliar-nfs-e parses prestador + tomador + valor + ISS + CNPJs. (3) The CNPJs get enriched via BrasilAPI for CNAE + regime tributário. (4) The enriched record gets handed to your accountant or written to a ledger. The renatoag wedge validation on 2026-04-27 surfaced this /solve/ task as the missing step (3).",
+            },
+        ],
+        methodological_caveats: [
+            "This is documented-characteristics ranking, not field-accuracy ranking. Numbers from vendor docs and curl tests against well-known CNPJs, not a real-corpus accuracy eval. A field-accuracy corpus run is Phase-2 follow-up tracked in backlog.md.",
+            "Free-tier vendor terms can change without notice. Re-check rate limits + auth requirements before relying on any source for critical workflows. last_verified: 2026-04-27.",
+            "Data freshness varies. BrasilAPI / CNPJ.ws publica / CNPJá open are cached from open data dumps with cadence ranging from daily (CNPJá) to ~30 days (BrasilAPI / CNPJ.ws). For situações cadastrais needing real-time, only paid tiers apply.",
+            "Inscrições Estaduais lag varies by state. CNPJ.ws sources from Sintegra which has per-state reporting cadence — some states report daily, others lag.",
+            "No commercial-enrichment fields. None of the 5 ranked sources include Serasa-style credit signals, employee count ranges (Speedio), or revenue estimates. If those matter, use a paid commercial enrichment provider.",
+        ],
+        update_cadence: "Re-run this ranking when: (a) BrasilAPI publishes a rate-limit cap or pricing tier (currently uncapped), (b) any of the 5 sources changes its free-tier shape (auth, field gating), (c) a Phase-2 field-accuracy corpus eval ships and updates the scorecard with measured numbers, (d) 90 days after first publish (2026-07-26).",
+        fit_by_agent: {
+            "claude-code": { "brasilapi-cnpj": true, "cnpja-cnpj": true, "cnpj-ws": true, "receitaws-cnpj": true, "mcp-gov-cnpj-fetch": true },
+            "claude-desktop": { "brasilapi-cnpj": true, "cnpja-cnpj": true, "cnpj-ws": true, "receitaws-cnpj": true, "mcp-gov-cnpj-fetch": true },
+            cursor: { "brasilapi-cnpj": true, "cnpja-cnpj": true, "cnpj-ws": true, "receitaws-cnpj": true, "mcp-gov-cnpj-fetch": true },
+            openclaw: { "brasilapi-cnpj": true, "cnpja-cnpj": true, "cnpj-ws": true, "receitaws-cnpj": true, "mcp-gov-cnpj-fetch": true },
+        },
+    },
 };

package/dist/server.js

@@ -13,9 +13,10 @@ import { findCapability } from "./tools/find-capability.js";
 import { getCapability } from "./tools/get-capability.js";
 import { listCapabilities } from "./tools/list-capabilities.js";
 import { compareCapabilities } from "./tools/compare-capabilities.js";
+import { invokeCapability } from "./tools/invoke-capability.js";
 const server = new McpServer({
     name: "auxiliar",
-    version: "0.11.0",
+    version: "0.12.0",
 });
 // Tool: recommend_service
 server.tool("recommend_service", "Get a current, verified recommendation for a cloud service based on your constraints. Returns pricing, risks, provision commands, and alternatives. Data is Chrome-verified from actual service websites (not stale training data).", {
@@ -158,6 +159,22 @@ server.tool("compare_capabilities", "Side-by-side comparison structure for 2-5 C
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
     };
 });
+// Tool: invoke_capability
+//
+// Phase 3 of the mcp-gov merge. The Capability index has long described
+// "what each tool does"; invoke_capability is the channel for *calling*
+// them. Routes to api.auxiliar.ai/api/invoke/<slug> where each slug is
+// a Python coroutine in backend/sources/<region>/. Returns the standard
+// envelope {tool, source_module, elapsed_ms, result}.
+server.tool("invoke_capability", "Execute a registered data-plane tool over HTTP. Use this to actually CALL a Capability the agent has discovered via find_capability/get_capability/list_capabilities — fetch a CNPJ, search Lei Rouanet projects, list Brasileirão standings, etc. Pass `tool` as the slug (e.g., 'fetch_cnpj', 'rouanet_projeto_fetch') and `args` as the kwargs dict the underlying function expects. Returns {tool, source_module, elapsed_ms, result}. Caching, rate limits, and retries are handled server-side.", {
+    tool: z.string().max(100).describe("Tool slug — the function name in the gateway registry (e.g., 'fetch_cnpj', 'rouanet_projeto_fetch', 'br_futebol_brasileirao_tabela'). Lowercase, underscore-separated, must start with a letter."),
+    args: z.record(z.string(), z.unknown()).optional().describe("Keyword arguments for the tool. Pass an empty object for no-arg tools. Unknown args return 400; missing required args return 400."),
+}, async (params) => {
+    const result = await invokeCapability(params);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools/invoke-capability.d.ts

@@ -0,0 +1,34 @@
+/**
+ * invoke_capability — execute a registered data-plane tool over HTTP.
+ *
+ * Phase 3 of the mcp-gov merge. Routes to api.auxiliar.ai/api/invoke/<slug>
+ * where each <slug> corresponds to a Python coroutine in
+ * backend/sources/<region>/. Returns the standard envelope:
+ *
+ *   { tool, source_module, elapsed_ms, result }
+ *
+ * Caching, rate limiting, and retries already happen server-side inside
+ * each source module — this client is intentionally thin.
+ *
+ * Env knobs:
+ *   - AUXILIAR_GATEWAY_URL   override base URL (default: api.auxiliar.ai)
+ *   - AUXILIAR_GATEWAY_KEY   sent as x-auxiliar-key header when set
+ *   - AUXILIAR_GATEWAY_TIMEOUT_MS  per-request timeout (default 60s,
+ *                                  matching the longest budgeted source)
+ */
+export interface InvokeCapabilityParams {
+    tool: string;
+    args?: Record<string, unknown>;
+}
+export interface InvokeEnvelope {
+    tool: string;
+    source_module: string | null;
+    elapsed_ms: number;
+    result: unknown;
+}
+export interface InvokeError {
+    error: string;
+    status?: number;
+    detail?: string;
+}
+export declare function invokeCapability(params: InvokeCapabilityParams): Promise<InvokeEnvelope | InvokeError>;

package/dist/tools/invoke-capability.js

@@ -0,0 +1,91 @@
+/**
+ * invoke_capability — execute a registered data-plane tool over HTTP.
+ *
+ * Phase 3 of the mcp-gov merge. Routes to api.auxiliar.ai/api/invoke/<slug>
+ * where each <slug> corresponds to a Python coroutine in
+ * backend/sources/<region>/. Returns the standard envelope:
+ *
+ *   { tool, source_module, elapsed_ms, result }
+ *
+ * Caching, rate limiting, and retries already happen server-side inside
+ * each source module — this client is intentionally thin.
+ *
+ * Env knobs:
+ *   - AUXILIAR_GATEWAY_URL   override base URL (default: api.auxiliar.ai)
+ *   - AUXILIAR_GATEWAY_KEY   sent as x-auxiliar-key header when set
+ *   - AUXILIAR_GATEWAY_TIMEOUT_MS  per-request timeout (default 60s,
+ *                                  matching the longest budgeted source)
+ */
+const DEFAULT_BASE_URL = "https://api.auxiliar.ai";
+const DEFAULT_TIMEOUT_MS = 60_000;
+function gatewayBaseUrl() {
+    return process.env.AUXILIAR_GATEWAY_URL || DEFAULT_BASE_URL;
+}
+function gatewayTimeoutMs() {
+    const raw = process.env.AUXILIAR_GATEWAY_TIMEOUT_MS;
+    if (!raw)
+        return DEFAULT_TIMEOUT_MS;
+    const n = parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : DEFAULT_TIMEOUT_MS;
+}
+export async function invokeCapability(params) {
+    const tool = String(params.tool || "").trim();
+    if (!tool) {
+        return { error: "tool slug is required" };
+    }
+    // Slug format must match the gateway registry — Python identifiers,
+    // no path separators or punctuation. Reject early so the user gets
+    // a clear local error rather than a 404 from the server.
+    if (!/^[a-z][a-z0-9_]*$/.test(tool)) {
+        return {
+            error: `invalid tool slug: ${tool}. Must match [a-z][a-z0-9_]*`,
+        };
+    }
+    const url = `${gatewayBaseUrl()}/api/invoke/${tool}`;
+    const headers = {
+        "content-type": "application/json",
+        "user-agent": "auxiliar-mcp/0.12",
+    };
+    const apiKey = process.env.AUXILIAR_GATEWAY_KEY;
+    if (apiKey) {
+        headers["x-auxiliar-key"] = apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), gatewayTimeoutMs());
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(params.args || {}),
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        let parsed;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        if (!response.ok) {
+            return {
+                error: `gateway returned ${response.status}`,
+                status: response.status,
+                detail: parsed?.detail ??
+                    text.slice(0, 500),
+            };
+        }
+        return parsed;
+    }
+    catch (err) {
+        const reason = err instanceof Error
+            ? err.name === "AbortError"
+                ? `request timed out after ${gatewayTimeoutMs()}ms`
+                : err.message
+            : String(err);
+        return { error: `gateway request failed: ${reason}` };
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}

package/dist/tools/solve.js

@@ -30,6 +30,24 @@ const taskAliases = {
     "brazilian-invoice": "nfs-e-extraction",
     "brazilian-nfs-e": "nfs-e-extraction",
     "cnpj-invoice": "nfs-e-extraction",
+    // CNPJ enrichment task — public-data lookup ranker (renatoag wedge follow-up)
+    "cnpj": "cnpj-enrichment-mcp",
+    "cnpj-lookup": "cnpj-enrichment-mcp",
+    "cnpj-enrichment": "cnpj-enrichment-mcp",
+    "cnpj-api": "cnpj-enrichment-mcp",
+    "brasilapi": "cnpj-enrichment-mcp",
+    "receitaws": "cnpj-enrichment-mcp",
+    "cnpja": "cnpj-enrichment-mcp",
+    "cnpj-ws": "cnpj-enrichment-mcp",
+    "cnae": "cnpj-enrichment-mcp",
+    "cnae-lookup": "cnpj-enrichment-mcp",
+    "regime-tributario": "cnpj-enrichment-mcp",
+    "simples-nacional": "cnpj-enrichment-mcp",
+    "razao-social": "cnpj-enrichment-mcp",
+    "supplier-enrichment": "cnpj-enrichment-mcp",
+    "supplier-registry": "cnpj-enrichment-mcp",
+    "company-lookup-brazil": "cnpj-enrichment-mcp",
+    "bookkeeping-cnpj": "cnpj-enrichment-mcp",
 };
 function resolveSlug(raw) {
     const lower = raw.toLowerCase().trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auxiliar-mcp",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Unified Capability index for AI agents — 80+ ranked cloud services, skills, MCP servers, plugins, parsers, and public-data sources for Claude Code, Cursor, Claude Desktop, OpenClaw. Call find_capability with a query or jtbd tag to get a ranked list across every kind of agent-installable thing. Also: get_capability, list_capabilities, compare_capabilities. Legacy tools (recommend_service, solve_task, list_services, list_solve_tasks, get_pricing, get_risks, setup_service, check_compatibility) remain wired for backward compatibility.",
   "type": "module",
   "main": "dist/server.js",