FiscalAPI

IE (27 UFs), CNPJ, certidões e cópia para leitura do XML de NF-e pela chave, do Brasil.

使うべきか

品質と安全性

B
説明の品質
95%
スキーマの完全性
81%
命名の品質
80%
ポイズニングのリスク
80%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(3)

  • HIGHTool poisoning patterns detected
  • LOWTool 'saldo' description lacks action verbsaldo 内
  • INFOTool description contains placeholder or incomplete textconsultar_ie_todos_estados 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~5,024トークン数(ツール定義)
~2.0 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 3.92%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "fiscalapi-mcp": {
      "url": "https://mcp.fiscalapi.com.br/mcp"
    }
  }
}

リモートエンドポイント

https://mcp.fiscalapi.com.br/mcpstreamable-http

できること

ツール一覧

ツール(13)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢validar_inscricao_estadual(uf, ie)

Confere o formato e o dígito verificador de uma Inscrição Estadual na UF informada. Não precisa de chave e não cobra. Não diz se a IE existe, está ativa ou a quem pertence: isso só a consulta real (consultar_ie) responde. Devolve valida, motivo da recusa, a IE formatada e quantos zeros à esquerda foram completados.

入力スキーマ

{
  "type": "object",
  "properties": {
    "uf": {
      "description": "Sigla da UF da inscrição, ex.: MT.",
      "enum": [
        "AC",
        "AL",
        "AM",
        "AP",
        "BA",
        "CE",
        "DF",
        "ES",
        "GO",
        "MA",
        "MG",
        "MS",
        "MT",
        "PA",
        "PB",
        "PE",
        "PI",
        "PR",
        "RJ",
        "RN",
        "RO",
        "RR",
        "RS",
        "SC",
        "SE",
        "SP",
        "TO"
      ],
      "title": "Uf",
      "type": "string"
    },
    "ie": {
      "description": "Número da IE, com ou sem pontuação.",
      "maxLength": 30,
      "title": "Ie",
      "type": "string"
    }
  },
  "required": [
    "uf",
    "ie"
  ],
  "title": "validar_inscricao_estadualArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "validar_inscricao_estadualDictOutput"
}
🟢cobertura

Resumo do que a FiscalAPI consulta por produto e UF, o que cada ferramenta devolve e os limites da API. Não precisa de chave e não cobra.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "title": "coberturaArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "coberturaDictOutput"
}
⚪consultar_ie(uf, cpf, cnpj, ie, secundarias, ...)

Consulta a Inscrição Estadual na UF informada, por CPF, CNPJ ou IE (um só). Devolve os dados cadastrais de cada inscrição: número, razão social, situação, tipo, endereço, CNAE, regime e datas. Por CPF não funciona em SP (lá, use CNPJ ou IE). Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "uf": {
      "description": "Sigla da UF, ex.: MT.",
      "enum": [
        "AC",
        "AL",
        "AM",
        "AP",
        "BA",
        "CE",
        "DF",
        "ES",
        "GO",
        "MA",
        "MG",
        "MS",
        "MT",
        "PA",
        "PB",
        "PE",
        "PI",
        "PR",
        "RJ",
        "RN",
        "RO",
        "RR",
        "RS",
        "SC",
        "SE",
        "SP",
        "TO"
      ],
      "title": "Uf",
      "type": "string"
    },
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "ie": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Número da Inscrição Estadual (informe só um documento).",
      "title": "Ie"
    },
    "secundarias": {
      "default": false,
      "description": "Busca também as atividades secundárias de cada inscrição. Pode somar de alguns a dezenas de segundos, conforme o estado.",
      "title": "Secundarias",
      "type": "boolean"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "uf"
  ],
  "title": "consultar_ieArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_ieDictOutput"
}
⚪consultar_ie_todos_estados(cpf, cnpj, ie, secundarias, confirmo_custo)

Procura inscrições estaduais nos 27 estados numa chamada, por CPF, CNPJ ou IE (um só), sem informar a UF. Devolve, por UF, as inscrições encontradas e o campo complete (false = algum estado não respondeu, então ausência não prova que não existe inscrição). Conta como 1 consulta. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "ie": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Número da Inscrição Estadual (informe só um documento).",
      "title": "Ie"
    },
    "secundarias": {
      "default": false,
      "description": "Busca também as atividades secundárias de cada inscrição. Pode somar de alguns a dezenas de segundos, conforme o estado.",
      "title": "Secundarias",
      "type": "boolean"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "title": "consultar_ie_todos_estadosArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_ie_todos_estadosDictOutput"
}
⚪consultar_cnpj(cnpj, ao_vivo, confirmo_custo)

Consulta o cadastro público de um CNPJ na Receita Federal: razão social, situação cadastral, abertura, CNAE, endereço, telefones, e-mail, quadro societário e opção pelo Simples e pelo MEI (base mensal da Receita Federal). Com ao_vivo=true consulta a Receita Federal na hora (mais lento; Simples e MEI voltam vazios). Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035); com ao_vivo=true, Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,075 (R$ 0,105). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cnpj": {
      "description": "CNPJ, com ou sem pontuação.",
      "maxLength": 24,
      "title": "Cnpj",
      "type": "string"
    },
    "ao_vivo": {
      "default": false,
      "description": "Consulta a Receita Federal na hora, ignorando o cache. Tem preço próprio (ver Custo).",
      "title": "Ao Vivo",
      "type": "boolean"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "cnpj"
  ],
  "title": "consultar_cnpjArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_cnpjDictOutput"
}
⚪consultar_cnd_estadual(uf, cpf, cnpj, confirmo_custo)

Consulta a Certidão Negativa de Débitos estadual (ICMS) de um CPF ou CNPJ (um só) na UF informada. Devolve o status (negativa, positiva, positiva_com_efeitos_de_negativa, nao_contribuinte, sem_certidao ou erro), emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "uf": {
      "description": "Sigla da UF, ex.: MT.",
      "enum": [
        "AC",
        "AL",
        "AM",
        "AP",
        "BA",
        "CE",
        "DF",
        "ES",
        "GO",
        "MA",
        "MG",
        "MS",
        "MT",
        "PA",
        "PB",
        "PE",
        "PI",
        "PR",
        "RJ",
        "RN",
        "RO",
        "RR",
        "RS",
        "SC",
        "SE",
        "SP",
        "TO"
      ],
      "title": "Uf",
      "type": "string"
    },
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "uf"
  ],
  "title": "consultar_cnd_estadualArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_cnd_estadualDictOutput"
}
⚪consultar_cndt(cpf, cnpj, confirmo_custo)

Consulta a Certidão Negativa de Débitos Trabalhistas (TST) de um CPF ou CNPJ (um só). Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "title": "consultar_cndtArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_cndtDictOutput"
}
⚪consultar_cnd_federal(cpf, cnpj, emitir_nova, confirmo_custo)

Consulta a certidão de débitos de tributos federais e Dívida Ativa da União (Receita Federal e PGFN) de um CPF ou CNPJ (um só). Se já existe certidão que vale por mais de 3 dias, devolve essa (modo=consulta); senão, emite uma nova (modo=emissao). Com emitir_nova=true, emite sempre. Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "emitir_nova": {
      "default": false,
      "description": "Emite uma certidão nova mesmo que já exista uma válida.",
      "title": "Emitir Nova",
      "type": "boolean"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "title": "consultar_cnd_federalArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_cnd_federalDictOutput"
}
⚪consultar_crf_fgts(cpf, cnpj, confirmo_custo)

Consulta o Certificado de Regularidade do FGTS (Caixa) de um CPF ou CNPJ (um só). Devolve status, emissão, validade e protocolo. O PDF não vem pelo MCP. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Resposta sem inscrição encontrada, sem_certidao ou nao_contribuinte conta como consulta. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cpf": {
      "anyOf": [
        {
          "maxLength": 20,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CPF, com ou sem pontuação (informe só um documento).",
      "title": "Cpf"
    },
    "cnpj": {
      "anyOf": [
        {
          "maxLength": 24,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CNPJ, com ou sem pontuação (informe só um documento).",
      "title": "Cnpj"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "title": "consultar_crf_fgtsArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_crf_fgtsDictOutput"
}
⚪baixar_xml_nfe_sem_certificado(chave, confirmo_custo)

Devolve uma cópia para leitura do XML de UMA NF-e (modelo 55) a partir da chave de acesso de 44 posições, sem certificado digital. A cópia vem sem a assinatura digital (assinado=false, tipo_xml=leitura): traz os dados da nota, mas não serve para validar schema nem assinatura. Status por chave: ok (com o XML), nao_encontrado ou erro. Custo por chave, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,05 (R$ 0,05). Cobra o XML entregue e também a chave cuja nota não foi encontrada (nao_encontrado); a mesma chave repetida logo depois de um nao_encontrado, chave inválida e erro não são cobrados. Precisa de plano ou créditos extras.

入力スキーマ

{
  "type": "object",
  "properties": {
    "chave": {
      "description": "Chave de acesso da NF-e (44 posições); separadores são ignorados.",
      "maxLength": 60,
      "title": "Chave",
      "type": "string"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "chave"
  ],
  "title": "baixar_xml_nfe_sem_certificadoArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "baixar_xml_nfe_sem_certificadoDictOutput"
}
⚪consultar_simples_nacional(cnpj, confirmo_custo)

Consulta a situação de um CNPJ no Simples Nacional (com a data da opção), no SIMEI e nos regimes regulares de IBS e CBS, com os eventos futuros. Para filiais, a situação é a da matriz. Custo por consulta, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,10 (R$ 0,12 com créditos extras); Pro R$ 0,065 (R$ 0,085); Enterprise R$ 0,025 (R$ 0,035). Erro não é cobrado. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "cnpj": {
      "description": "CNPJ, com ou sem pontuação.",
      "maxLength": 24,
      "title": "Cnpj",
      "type": "string"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "cnpj"
  ],
  "title": "consultar_simples_nacionalArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_simples_nacionalDictOutput"
}
⚪consultar_nfse(chave, confirmo_custo)

Consulta UMA NFS-e do padrão nacional pela chave de acesso de 50 dígitos, sem certificado digital: emitente, tomador, serviço, tributação municipal e federal e situação de geração (situacao não indica cancelamento). Uma consulta nova leva de 30 a 60 segundos. O PDF do DANFSe não vem por aqui. Custo por nota, descontado do saldo em créditos (1 crédito = R$ 1): Starter R$ 0,30 (R$ 0,36 com créditos extras); Pro R$ 0,195 (R$ 0,255); Enterprise R$ 0,05 (R$ 0,05). Cobra só a NFS-e entregue; chave inválida, nota não encontrada e erro não são cobrados. Exige plano ou créditos extras: as 10 consultas grátis do mês são só no painel, não valem pelo MCP.

入力スキーマ

{
  "type": "object",
  "properties": {
    "chave": {
      "description": "Chave de acesso da NFS-e (50 dígitos); separadores são ignorados.",
      "maxLength": 70,
      "title": "Chave",
      "type": "string"
    },
    "confirmo_custo": {
      "default": false,
      "description": "Obrigatório para executar: true só depois que o usuário aceitou o custo descrito na ferramenta. Sem isso a ferramenta só explica o custo e não consulta nada.",
      "title": "Confirmo Custo",
      "type": "boolean"
    }
  },
  "required": [
    "chave"
  ],
  "title": "consultar_nfseArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "consultar_nfseDictOutput"
}
⚪saldo

Saldo da conta em créditos (1 crédito = R$ 1) e quanto ele ainda rende. creditos traz plano (créditos do plano que restam no ciclo), extras (créditos extras, não vencem), guardados (créditos do plano que sobraram quando o plano venceu; voltam ao assinar um plano) e disponivel (plano + extras). consultas_restantes (IE, CNPJ, certidões) e notas_restantes (XML de NF-e) dividem o mesmo saldo. notas_restantes conta o XML com certificado; no Enterprise o XML sem certificado custa o dobro. Usa a chave da FiscalAPI e não consome consulta.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "title": "saldoArguments"
}

出力スキーマ

{
  "type": "object",
  "additionalProperties": true,
  "title": "saldoDictOutput"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 13 件