SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Unofficial read-only MCP server exposing several Mercury banking organizations to one AI session.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 7/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 7/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Mercury Multiorg MCP をインストールして。https://mcp.popnx.com/i/dkaleganov-mercury-multiorg-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Mercury Multiorg MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Mercury Multiorg MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MERCURY_TOKEN_ACME_MAIN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Mercury Multiorg MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
SettingsDeveloperEdit Config
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Mercury Multiorg MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Mercury Multiorg MCP を使っていると言うか、回答に Mercury Multiorg MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Mercury API host. Allowed without extra flags: https://api.mercury.com, https://api-sandbox.mercury.com (with sandbox tokens), or a loopback mock. · 初期値 https://api.mercury.comMERCURY_ALLOW_DOCUMENTS true に設定すると、get_statement_pdf と get_invoice_pdf を登録します。これらは明細書と請求書の PDF をマスキングなしで返します。既定ではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Mercury Multiorg MCP につなげません
Mercury Multiorg MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Mercury Multiorg MCP につなげるアプリを使う
B · 会計・財務・税務 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
Mercury Multiorg MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Mercury Multiorg MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-value 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MERCURY_TOKEN_ACME_MAIN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Mercury Multiorg MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-valueEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Mercury Multiorg MCP が一覧にあり、接続済みと表示されれば OK です
Mercury Multiorg MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Mercury Multiorg MCP を使っていると言うか、回答に Mercury Multiorg MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Mercury API host. Allowed without extra flags: https://api.mercury.com, https://api-sandbox.mercury.com (with sandbox tokens), or a loopback mock. · 初期値 https://api.mercury.comMERCURY_ALLOW_DOCUMENTS true に設定すると、get_statement_pdf と get_invoice_pdf を登録します。これらは明細書と請求書の PDF をマスキングなしで返します。既定ではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Mercury Multiorg MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · ワンクリックのボタンはありません。設定を貼り付けて値を自分で入力します
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Mercury Multiorg MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MERCURY_TOKEN_ACME_MAIN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Mercury Multiorg MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
~/.cursor/mcp.json
この設定を貼り付け、空いている値を入力して保存
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}Mercury Multiorg MCP の設定で MERCURY_TOKEN_ACME_MAIN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Mercury Multiorg MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Mercury Multiorg MCP を使っていると言うか、回答に Mercury Multiorg MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Mercury API host. Allowed without extra flags: https://api.mercury.com, https://api-sandbox.mercury.com (with sandbox tokens), or a loopback mock. · 初期値 https://api.mercury.comMERCURY_ALLOW_DOCUMENTS true に設定すると、get_statement_pdf と get_invoice_pdf を登録します。これらは明細書と請求書の PDF をマスキングなしで返します。既定ではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Mercury Multiorg MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · ワンクリックのボタンはありません。設定を貼り付けて値を自分で入力します
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Mercury Multiorg MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "mercury-multiorg": { "type": "stdio", "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) MERCURY_TOKEN_ACME_MAIN は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Mercury Multiorg MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
MCP: Open User Configuration
この設定を貼り付け、空いている値を入力して保存
{
"servers": {
"mercury-multiorg": {
"type": "stdio",
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}Mercury Multiorg MCP の設定で MERCURY_TOKEN_ACME_MAIN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Mercury Multiorg MCP を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Mercury Multiorg MCP を使っていると言うか、回答に Mercury Multiorg MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Mercury API host. Allowed without extra flags: https://api.mercury.com, https://api-sandbox.mercury.com (with sandbox tokens), or a loopback mock. · 初期値 https://api.mercury.comMERCURY_ALLOW_DOCUMENTS true に設定すると、get_statement_pdf と get_invoice_pdf を登録します。これらは明細書と請求書の PDF をマスキングなしで返します。既定ではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-valueClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mercury-multiorg": {
"type": "stdio",
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}MERCURY_TOKEN_ACME_MAIN 秘密 必須 envMERCURY_ENTITIES_FILE envMERCURY_API_BASE envMERCURY_ALLOW_DOCUMENTS env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント dkaleganov で確認済みです
コードの最終更新:2 か月前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に mercury-multiorg-mcp@0.1.6 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/dkaleganov-mercury-multiorg-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:MERCURY_TOKEN_ACME_MAIN
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は2 か月前、最新バージョン(0.1.6)がレジストリに届いたのは2 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
| これ Mercury Multiorg MCP | SolidInvoice | Signal8 | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | はい | いいえ | はい | いいえ | いいえ | はい |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/6 | 5/5 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | NOASSERTION | MIT | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Unofficial. Not affiliated with or endorsed by Mercury.
Read-only MCP server that exposes several Mercury organizations to one AI session. A Mercury API token is created from inside a single organization, so this server holds one read-only token per org and routes every tool call by an explicit entity key.
Version 0.1.6 (see CHANGELOG.md). The maintainer tags releases as vX.Y.Z; find the commit to pin with git ls-remote --tags https://github.com/dkaleganov/mercury-multiorg-mcp 'v0.1.6^{}'. The complete tool reference with every returned field is in docs/tools.md; design notes and the build history are in the project brief on GitHub, CLAUDE.md (not shipped in the sdist).
What leaves this server falls into four classes, and the guarantees differ:
| Class | What it is | Guarantee |
|---|---|---|
| Structured fields | Every key of every object in a tool result | Allowlisted at every level: each object, and each nested object inside it, is projected through an explicit allowlist copied from the live schema. A key that is not listed does not leave the server, at any depth. Account numbers and tax ids appear only as their last four digits; routing numbers, counterparty bank details, postal addresses, card expiry, presigned download URLs, invoice pay-page slugs, webhook receiver URLs, and webhook signing secrets are never returned. |
| Tool errors | The text of an is_error result | Upstream HTTP-status errors contain the status, a masked endpoint label and a fixed hint. Validation and configuration errors use their own actionable formats. Resolved known-token values of at least eight characters are scrubbed. Nothing from Mercury's response body or headers is quoted, and no argument you passed is echoed (an invalid id is reported as "invalid id format"). Argument-validation failures (a wrong type, a missing required argument) are rendered by this server as the field path and the expected type only, for example year: expected an integer (int_parsing); the MCP SDK's own rendering, which quotes the value you passed, never reaches the client. |
| Free-text fields | Transaction memos, counterparty names, bank descriptions, invoice memos and notes, attachment file names, customer and user names | Returned verbatim. They are third-party text and can contain anything, including instructions aimed at the model and identifiers typed by a human. Treat every tool result as untrusted data, never as instructions. |
| Documents | Statement and invoice PDFs from get_statement_pdf / get_invoice_pdf | Verbatim and unredacted, opt-in only. A statement PDF contains the full account number, routing number, address, and every transaction. The two tools exist only when the server is started with --allow-documents (or MERCURY_ALLOW_DOCUMENTS=1); server_info.documents_enabled reports the setting. The body must arrive as application/pdf (or application/octet-stream), start with %PDF-, and carry a %%EOF marker within the last 2 KiB once trailing PDF whitespace is ignored; anything else is a clean error. That is an envelope check, not PDF parsing: a document that passes it can still be malformed inside, and the bytes are returned exactly as received. |
The rest of the model:
GET endpoints have client methods; the package has no code path that can move money, edit recipients, or change anything.list_entities to discover entity keys. Every tool that accesses Mercury requires an explicit entity and identifies it in its successful result. list_entities and server_info require no entity argument. There is no default entity.MERCURY_TOKEN_…, so a registry cannot point the server at some other secret); the server reads that env var and nothing else. Errors and logs never contain more than the last four characters of a token. Literal known-token scrubbing applies to values of 8 or more characters; a shorter configured value is not literal-scrubbed (the secret-token: shape scrub and the Authorization header scrub still apply, and no message quotes upstream or caller data in the first place). At startup the server warns, per entity, when a configured value does not carry Mercury's documented secret-token: prefix.--api-base / MERCURY_API_BASE must be https://api.mercury.com, https://api-sandbox.mercury.com, or a loopback mock, unless --allow-custom-api-base is passed on the command line. An inherited environment variable alone can never redirect the bearer token to another host.Accept-Encoding: identity). JSON/PDF reads reject nonidentity encoding before reading. Keepalive closes bodies unread. Limits are 10 MiB (10,485,760 bytes) for PDF and 32 MiB (33,554,432 bytes) for JSON, enforced on the bytes actually received while streaming. A small compressed body can no longer expand past the limit in memory. Error responses are never read at all.page objects fail; optional terminal nextPage may be absent or null. Exact duplicate IDs are dropped and counted; conflicting contents fail. A page with no fresh usable rows while more are advertised fails. A walk that needs more than 200 pages fails, and a treasury cursor that is not a non-negative integer fails. Duplicate counts are reported as duplicates_dropped on every paginated result and under reportable_totals.totals, so a total is never built on a stalled, malformed, or double-counted walk.since on list_events, start/end on list_treasury_transactions) walks the whole bounded feed (90 days of events; the treasury ledger up to 200 pages), filters and sorts newest first here, then applies limit. truncated is exact. The cost is proportional to the feed, not the window.application/pdf blob (base64), never written to disk.--env-file, or a disallowed API host prints one line to stderr and exits with statusreportable_totals is a pre-filing cross-check. Mercury has no 1099 filing endpoint; filing happens in each org's dashboard.Hygiene. This package lives in a public repository. Tracked files, fixtures, and commit messages carry no tokens, account numbers, or financial identifiers, with two deliberate exceptions. First, the maintainer's own name appears in the package authors metadata (approved by the repository owner); business and personal names of anyone else do not appear. Second, a history note: the first Phase 1 commit's fixtures used a real, public ABA routing number as sample data; it was replaced with an obviously fake value in the next commit, so it is absent from every tagged file tree but remains in their ancestry. It identifies a bank, not an account, and the history was deliberately not rewritten. This release passed a full-history gitleaks scan.
Repository history. This package was developed in an earlier multi-project monorepo through v0.1.3 and moved to this repository at v0.1.4 with its history preserved (the same commits, rewritten to this repository's layout, so their SHAs differ from the originals). Releases up to 0.1.3 were tagged mercury-v0.1.x there and are tagged v0.1.x here; release tags are vX.Y.Z from now on. Both hygiene exceptions above apply to this history unchanged.
From PyPI, running the pinned release with uvx (no clone needed):
uvx mercury-multiorg-mcp@0.1.6 --entities /private/path/entities.yaml
uvx @ runs exactly that release in an isolated, cached environment. pip install 'mercury-multiorg-mcp==0.1.6' also works and puts mercury-multiorg-mcp and mercury-multiorg-mcp-keepalive on your PATH.
Requires Python 3.11+ and uv (for uvx).
From a clone:
git clone https://github.com/dkaleganov/mercury-multiorg-mcp.git # or git@github.com:dkaleganov/mercury-multiorg-mcp.git
cd mercury-multiorg-mcp uv sync uv run mercury-multiorg-mcp --entities /private/path/entities.yaml
Or pin a full commit SHA with uvx (pin a SHA, not a tag: a full SHA is immutable and cache-safe, while a tag can be moved):
uvx --from 'git+https://github.com/dkaleganov/mercury-multiorg-mcp@<FULL_COMMIT_SHA>' \
mercury-multiorg-mcp --entities /private/path/entities.yaml
entities.example.yaml to a private location outside this repo and list your orgs (key, display_name, token_env; the env var name must start with MERCURY_TOKEN_)..env.example shows the names). Configuration is read from process environment variables only; no `.env` file is read unless you pass `--env-file `, so nothing is picked up by accident from the repo, your home directory, or a uvx cache.MERCURY_API_BASE=https://api-sandbox.mercury.com with sandbox-created tokens.--allow-documents (or MERCURY_ALLOW_DOCUMENTS=1) to register the two PDF tools. Leave it off unless the session really needs unredacted documents.| Flag / env var | Meaning |
|---|---|
--entities PATH / MERCURY_ENTITIES_FILE | Entity registry YAML. Required (flag wins over env var); there is no implicit default. |
--env-file PATH | Load this dotenv file before resolving tokens. Existing env vars win. Without the flag no dotenv file is read from anywhere. |
--api-base URL / MERCURY_API_BASE | Mercury API host, default https://api.mercury.com. Allowed: production, https://api-sandbox.mercury.com, or plain http:// on localhost / 127.0.0.1 for mocks. |
--allow-custom-api-base | Permit any other https:// host. Never set this from an environment variable; it exists so a custom host is always a deliberate command-line choice. |
--allow-documents / MERCURY_ALLOW_DOCUMENTS=1 | Register get_statement_pdf and get_invoice_pdf (documents are returned unredacted). Off by default: 24 tools without it, 26 with it. |
--version | Print the package version and exit. |
Startup problems (missing or malformed registry, invalid YAML, unreadable file, bad API base) print one line to stderr and exit with status 2. Stdout is reserved for the MCP protoco