{
  "server": "@nfe/mcp-server",
  "name": "nfeio-mcp-server",
  "version": "0.3.0",
  "description": "Official Model Context Protocol server for the NFE.io API. Works with no authentication — POST MCP JSON-RPC to /mcp. Tools that consume the NFE.io API require a key; send it via the X-NFE-API-Key header (or Authorization: Bearer).",
  "auth": {
    "required": false,
    "fiscalKey": "X-NFE-API-Key (or Authorization: Bearer <key>)",
    "lookupKey": "X-NFE-Lookup-Key (optional; falls back to the fiscal key)",
    "defaultCompany": "X-NFE-Company-Id (optional)",
    "getKey": "https://app.nfe.io",
    "oauth": {
      "authorizationServer": "https://idx.nfe.io/realms/nfeio",
      "clientId": "nfeio-mcp-server",
      "resourceMetadata": "/.well-known/oauth-protected-resource/mcp",
      "note": "Tools that consume the NFE.io API answer 401 + WWW-Authenticate when called with no credential — OAuth-capable MCP clients (e.g. Claude custom connectors) show a Connect card and retry automatically."
    }
  },
  "endpoints": {
    "mcp": "/mcp",
    "health": "/healthz"
  },
  "limits": {
    "rateLimitPerIpPerMinute": 60,
    "rateLimit": "60 requests/minute per IP on POST /mcp",
    "cacheTtl": {
      "ibge": "24h (CNAE, municipalities, states)",
      "bcb": "1h (Selic, IPCA, PTAX)"
    },
    "on429": "HTTP 429 with a JSON-RPC error body and a Retry-After header (seconds); back off and retry."
  },
  "docs": "https://nfe.io/docs/mcp",
  "tools": [
    "nfeio_issue_service_invoice",
    "nfeio_list_service_invoices",
    "nfeio_get_invoice_status",
    "nfeio_list_companies",
    "nfeio_get_company",
    "nfeio_create_company",
    "nfeio_lookup_cnpj",
    "nfeio_lookup_address",
    "nfeio_validar_cpf",
    "nfeio_validar_cnpj",
    "nfeio_validar_chave_nfe",
    "nfeio_consultar_municipios",
    "nfeio_consultar_estado",
    "nfeio_consultar_cnae",
    "nfeio_buscar_cnae",
    "nfeio_indexador_selic",
    "nfeio_indexador_ipca",
    "nfeio_corrigir_valor",
    "nfeio_cambio_ptax",
    "nfeio_validar_cst",
    "nfeio_consultar_aliquota_icms"
  ]
}