sendnf

SendNF MCP

SendNF の MCP サーバーです。AI エージェントと会話しながら 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	読み取り	キーのモード（テストまたは本番）、プラン、当月の使用状況、キーが1社限定かどうか、登録済みの各社とそれぞれの不足項目を確認します。
usage_by_company	読み取り	期間内の各社の請求書（種類、ステータス、環境別）、承認済みの本番請求書、CNPJが有効だったかどうか、各社の請求見積もりを確認します。
go_live_status	読み取り	各社について、NFS-eのチェックリストが完了しているか、テスト請求書を送信済みか、本番請求書の発行が有効になっているか（live_enabled_at）、およびその状態を確認します。
lookup_cnpj	読み取り	Receitaの企業公開情報（法人名、住所、CNAE、Simples/MEI）を検索し、市役所がSistema Nacionalと独自システムのどちらを使用しているかを調べ、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	書き込み	企業が発行済みの請求書（NFS-e Nacionalまたは市のNFS-e、NF-e、NFC-e）のXMLを読み取り、企業の登録または情報の補完を行います。登録・補完する情報には、登録番号、税制、サービスコード、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を発行し、結果（authorized、rejected、blocked、pending）が返るまで最大約25秒待ちます。
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と、notes.csv/notes.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、status 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秒待ちます。