Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Mercury Multiorg MCP

by dkaleganovversion 0.1.6i★ 0iRuns on your computerRepository ↗
Registry nameio.github.dkaleganov/mercury-multiorg-mcp

How to install

What it does

Unofficial read-only MCP server exposing several Mercury banking organizations to one AI session.

  • Connects Runs on your computer
  • Account or key Needs MERCURY_TOKEN_ACME_MAIN
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score7/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Mercury Multiorg MCP. Follow https://mcp.popnx.com/i/dkaleganov-mercury-multiorg-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Mercury Multiorg MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MERCURY_TOKEN_ACME_MAIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Mercury Multiorg MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Mercury Multiorg MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "mercury-multiorg": {
          "command": "uvx",
          "args": [
            "mercury-multiorg-mcp",
            "--entities",
            "your-value"
          ],
          "env": {
            "MERCURY_TOKEN_ACME_MAIN": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Mercury Multiorg MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Mercury Multiorg MCP or shows a Mercury Multiorg MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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. · default https://api.mercury.com
  • MERCURY_ALLOW_DOCUMENTS Set to true to register get_statement_pdf and get_invoice_pdf, which return statement and invoice PDFs unredacted. Off by default. · default false

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Mercury Multiorg MCP yet

Mercury Multiorg MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Mercury Multiorg MCP

  • You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
  • You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · No one-click button: paste the settings and fill in the values yourself
  • You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · No one-click button: paste the settings and fill in the values yourself

B · Others in Accounting, finance & tax that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Mercury Multiorg MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-value 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MERCURY_TOKEN_ACME_MAIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Mercury Multiorg MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Mercury Multiorg MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-value

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Mercury Multiorg MCP listed as connected

  6. Try it

    Use Mercury Multiorg MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Mercury Multiorg MCP or shows a Mercury Multiorg MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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. · default https://api.mercury.com
  • MERCURY_ALLOW_DOCUMENTS Set to true to register get_statement_pdf and get_invoice_pdf, which return statement and invoice PDFs unredacted. Off by default. · default false

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · No one-click button: paste the settings and fill in the values yourself

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Mercury Multiorg MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MERCURY_TOKEN_ACME_MAIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Mercury Multiorg MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Mercury Multiorg MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open Cursor’s MCP settings file

    ~/.cursor/mcp.json

    Paste these settings, fill in the empty values and save

    {
      "mcpServers": {
        "mercury-multiorg": {
          "command": "uvx",
          "args": [
            "mercury-multiorg-mcp",
            "--entities",
            "your-value"
          ],
          "env": {
            "MERCURY_TOKEN_ACME_MAIN": "your-value"
          }
        }
      }
    }
  4. Fill in your key

    In the Mercury Multiorg MCP settings, MERCURY_TOKEN_ACME_MAIN is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Mercury Multiorg MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Mercury Multiorg MCP or shows a Mercury Multiorg MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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. · default https://api.mercury.com
  • MERCURY_ALLOW_DOCUMENTS Set to true to register get_statement_pdf and get_invoice_pdf, which return statement and invoice PDFs unredacted. Off by default. · default false

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Mercury Multiorg MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · No one-click button: paste the settings and fill in the values yourself

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Mercury Multiorg MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "mercury-multiorg": { "type": "stdio", "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For MERCURY_TOKEN_ACME_MAIN, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Mercury Multiorg MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Sign up and create a Mercury Multiorg MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open VS Code’s MCP settings file

    MCP: Open User Configuration

    Paste these settings, fill in the empty values and save

    {
      "servers": {
        "mercury-multiorg": {
          "type": "stdio",
          "command": "uvx",
          "args": [
            "mercury-multiorg-mcp",
            "--entities",
            "your-value"
          ],
          "env": {
            "MERCURY_TOKEN_ACME_MAIN": "your-value"
          }
        }
      }
    }
  4. Fill in your key

    In the Mercury Multiorg MCP settings, MERCURY_TOKEN_ACME_MAIN is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Mercury Multiorg MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Mercury Multiorg MCP or shows a Mercury Multiorg MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • 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. · default https://api.mercury.com
  • MERCURY_ALLOW_DOCUMENTS Set to true to register get_statement_pdf and get_invoice_pdf, which return statement and invoice PDFs unredacted. Off by default. · default false

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Mercury Multiorg MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-value

Claude 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"
      }
    }
  }
}

Values you fill in

  • MERCURY_TOKEN_ACME_MAIN secret required env
    Example only. Each organization needs one read-only Mercury API token in the environment variable named by its token_env in your registry. Names are yours to choose but must match MERCURY_TOKEN_[A-Z0…
  • MERCURY_ENTITIES_FILE env
    Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.
  • MERCURY_API_BASE env
    Mercury API host. Allowed without extra flags: https://api.mercury.com, https://api-sandbox.mercury.com (with sandbox tokens), or a loopback mock.
  • MERCURY_ALLOW_DOCUMENTS env
    Set to true to register get_statement_pdf and get_invoice_pdf, which return statement and invoice PDFs unredacted. Off by default.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
23/wk
Connection
Runs on your computer
Latest versioni
0.1.6
Published to registryi
Sep 15, 2026
Code last changedi
Sep 15, 2026
Maker
dkaleganov
Packages
pypi: mercury-multiorg-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account dkaleganov, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 months ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for mercury-multiorg-mcp@0.1.6

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/dkaleganov-mercury-multiorg-mcp.svg)](https://mcp.popnx.com/en/servers/dkaleganov-mercury-multiorg-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 0% of the other 3423 servers in this category
  • Published to the registry more recently than 31% of the other 3423 servers in this category
  • Basic checks equal to or better than 99% of the other 3423 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Mercury Multiorg MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: MERCURY_TOKEN_ACME_MAIN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 2 months ago, and the latest version (0.1.6) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

by signal8aiGrowing↓ 431/wk★ 425Updated 10 days ago

Computer or cloud✓ service owner · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 261Updated 11 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 702 Stars for the whole repoUpdated 44 days ago

Runs in the cloud✓ service owner · beancount.io
Compared with similar ones
This one
Mercury Multiorg MCP
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Runs whereInstalls on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyYesNoYesNoNoYes
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/65/54/44/45/5
LicenseMITMITMITNOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mercury-multiorg-mcp

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).

Security model

What leaves this server falls into four classes, and the guarantees differ:

ClassWhat it isGuarantee
Structured fieldsEvery key of every object in a tool resultAllowlisted 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 errorsThe text of an is_error resultUpstream 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 fieldsTransaction memos, counterparty names, bank descriptions, invoice memos and notes, attachment file names, customer and user namesReturned 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.
DocumentsStatement and invoice PDFs from get_statement_pdf / get_invoice_pdfVerbatim 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:

  • Read-only. Only GET endpoints have client methods; the package has no code path that can move money, edit recipients, or change anything.
  • Stdio only. The server never opens a network listener.
  • Explicit entity. Call 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.
  • Tokens stay in the environment. The registry names an env var per org (it must be named 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.
  • Only Mercury hosts. --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.
  • Byte limits on wire bytes. Every request declines compression (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.
  • Complete or loud. Walks stop at the requested limit or API end. Missing/wrong 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.
  • Windowed feeds are walked in full. Mercury documents no sort key for events or treasury transactions, so a client-side window (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.
  • Binary documents stay in memory. PDFs come back as an embedded application/pdf blob (base64), never written to disk.
  • Path ids are validated. Every id that becomes part of a request path must be a single safe segment; nothing can redirect a call to another endpoint.
  • Startup errors are one line, exit 2. A missing or malformed registry (including non-string YAML keys), an unreadable file, a bad --env-file, or a disallowed API host prints one line to stderr and exits with status
  1. The redacting exception hooks are installed before anything is loaded, so no startup path can print an unredacted traceback.
  • Never files anything. reportable_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.

Install

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 source / pinned commit

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

Configure

  1. In each Mercury org: org switcher → All Settings → Tokens → create a Read Only token (no IP allowlist required).
  2. Copy 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_).
  3. Export one env var per org, named as in the registry, in the environment that launches the server (.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.
  4. Optional: MERCURY_API_BASE=https://api-sandbox.mercury.com with sandbox-created tokens.
  5. Optional: --allow-documents (or MERCURY_ALLOW_DOCUMENTS=1) to register the two PDF tools. Leave it off unless the session really needs unredacted documents.
Command line
Flag / env varMeaning
--entities PATH / MERCURY_ENTITIES_FILEEntity registry YAML. Required (flag wins over env var); there is no implicit default.
--env-file PATHLoad 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_BASEMercury 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-basePermit 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=1Register get_statement_pdf and get_invoice_pdf (documents are returned unredacted). Off by default: 24 tools without it, 26 with it.
--versionPrint 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

Only the beginning is shown; read the rest in the repo