sendnf

SendNF MCP

SendNF 的 MCP 服务：与 AI Agent 对话即可开具 NFS-e 和 NFC-e。查询 CNPJ、服务代码、预开具、开具和取消。

• URL：https://api.sendnf.com/mcp（Streamable HTTP，无会话）
• 认证：Authorization: Bearer <chave>。nt_test_... 密钥用于测试环境（不具备税务效力）；nt_live_... 密钥用于生产环境。未提供密钥时，服务会返回 401。
• 文档：https://sendnf.com/mcp/

此代码仓库仅包含清单、示例和工具列表。产品代码为私有。

配置

{
  "mcpServers": {
    "sendnf": {
      "type": "http",
      "url": "https://api.sendnf.com/mcp",
      "headers": { "Authorization": "Bearer nt_test_SUA_CHAVE" }
    }
  }
}

工具（36）

工具	类型	功能
account_overview	读取	密钥模式（测试或生产）、套餐、本月用量、密钥是否仅限一家企业使用，以及已登记的企业和每家企业缺少的信息。
usage_by_company	读取	各企业在指定期间的票据（按类型、状态和环境分类）、已获授权的实际票据、CNPJ 是否处于活跃状态，以及各企业的费用估算。
go_live_status	读取	按企业显示：NFS-e 检查清单是否已完成、是否已通过测试票据、是否已启用真实票据开具（live_enabled_at）以及当前状态
lookup_cnpj	读取	从 Receita 查询企业的公开信息（法定名称、地址、CNAE、Simples/MEI），查明市政府使用的是国家系统还是自有系统，并根据 CNAE 推荐服务代码。
search_service_codes	读取	在国家服务清单（LC 116）中搜索国家税收代码（cTribNac，6 位数字）和 NBS。
get_service_code	读取	国家税收代码的官方说明及其可能对应的 NBS。
how_to_get	读取	获取难以查找的税务信息的分步指南（各州 CSC、市政登记号、市政府密码），并提供官方来源。
list_companies	读取	账户中的开票企业（id、CNPJ、名称、税制、城市、external_id 和 metadata）。
find_company_by_external_id	读取	根据企业在集成商系统中的 id（external_id）获取企业信息和检查清单。
get_company	读取	企业信息、Receita 公开信息，以及开具 NFS-e 和 NFC-e 所需的待办检查清单，并为每项待办提供指南。
create_company	写入	登记开票企业。
import_invoice	写入	读取企业已开具票据的 XML（国家或市级 NFS-e、NF-e 或 NFC-e），并登记或补全企业信息：登记号、税制、服务代码、NBS、ISS 税率、市级代码和票据编号（系列和下一个号码）。
update_company	写入	更新企业信息（例如：市政登记号、默认服务代码、NFC-e 的 CSC、市政府密码、emits_nfce、external_id、metadata；null 会清除 external_id 和 metadata）。
upload_certificate	写入	上传 A1 数字证书（base64 编码的 .pfx 文件 + 密码）。
check_readiness	读取	企业开票所缺少的信息，并附带指南。
create_onboarding_link	写入	生成企业登记页面的短链接（如果账户已启用白标，则使用该账户的白标），供企业所有者自行补全缺失信息：A1 证书和密码，
get_branding	读取	账户的白标设置：是否已启用、名称、徽标、颜色、支持邮箱、回复地址、可嵌入登记页面的来源，以及邮件发送域名（含 DNS 状态）。
create_share_link	写入	创建安全的只读链接，供接收者（会计部门、合伙人或其他系统）无需登录即可查看和下载已获授权及已取消的票据（PDF、XML 和当月 ZIP）。
list_share_links	读取	列出票据共享链接：企业、期间、有效期、当前是否处于有效、已过期或已撤销状态、最后访问时间和访问次数。
revoke_share_link	写入	撤销票据共享链接：链接将立即失效。
preview_nfse	读取	在不传输的情况下模拟 NFS-e：按照官方格式（或市政府服务提供商的格式）进行验证、计算总额及 IBS/CBS，并列出问题和相应指南。
issue_nfse	写入	开具 NFS-e，并等待最多约 25 秒以获取结果（authorized、rejected、blocked 或 pending）。
preview_nfce	读取	在不传输的情况下模拟 NFC-e（向消费者销售商品），并列出问题和相应指南。
issue_nfce	写入	开具 NFC-e，并等待最多约 25 秒以获取结果。
list_documents	读取	当前模式下的票据，按时间从新到旧排列。
get_document	读取	票据状态和详情：已解释的拒绝原因、blocked_reason、传输尝试情况（attempts、max_attempts、next_attempt_at、last_error）、是否仍可取消或替换（cancellation），以及 PDF/XML 链接。
create_export	写入	请求批量导出：包含指定期间所有票据 XML 和 PDF 的 ZIP 文件（按企业和月份分文件夹），以及 notas.csv/notas.xlsx 电子表格（号码、日期、受票方、CPF/CNPJ、金额、ISS、预扣款、状态、密钥）。
get_export	读取	导出的状态（queued、running、ready、failed、expired）、进度（done/total），以及导出完成后的 download_url（有效期为 1 小时的签名链接；文件保存 7 天）。
get_document_events	读取	票据时间线（已创建、已发送、已授权、已拒绝、已阻止、已取消……），用于向用户说明票据发生了什么。
cancel_document	写入	在 Receita/市政府/SEFAZ 取消整张票据。
get_substitution_draft	读取	判断 NFS-e 是否可以通过替换进行更正（“部分取消”），并返回原票据内容，供编辑后发送给 substitute_document。
substitute_document	写入	对 NFS-e 进行“部分取消”或更正金额/数据：使用提供的项目和金额开具替代票据，并指向原票据，
create_note_draft	写入	创建 NFS-e（kind nfse）或 NFC-e（kind nfce），并等待人工批准，即使审批锁定已关闭也是如此：按照正式开具流程验证（登记信息、官方格式、总额），并返回包含 id、状态 pending_approval、approval_url 的草稿；对于 NFS-e，还会返回 preview_pdf_url（不具备税务效力的预览）。
list_pending_approvals	读取	当前模式下待处理的开具、取消和替换草稿，按时间从新到旧排列。
get_approval_status	读取	草稿状态：pending_approval（等待人工处理）、approved（返回已开具/已取消的票据）、rejected（返回 rejection_reason：请更正并重新创建）、expired（7 天内无人处理）或 failed（已批准，但开具时出错；请查看 error）。
retry_document	写入	立即传输状态为 pending、blocked（补全缺失信息后）或 failed（“未发送”，即 SendNF 已停止重试）的票据，并等待最多约 25 秒以获取结果。