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.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 7/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 7/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Mercury Multiorg MCP. Sigue https://mcp.popnx.com/i/dkaleganov-mercury-multiorg-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Mercury Multiorg MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Mercury Multiorg MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MERCURY_TOKEN_ACME_MAIN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Mercury Multiorg MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Mercury Multiorg MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Mercury Multiorg MCP o muestra una herramienta de Mercury Multiorg MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Host de la API de Mercury. Permitidos sin indicadores adicionales: https://api.mercury.com, https://api-sandbox.mercury.com (con tokens de sandbox) o un mock de loopback. MERCURY_ALLOW_DOCUMENTS Establezca en true para registrar get_statement_pdf y get_invoice_pdf, que devuelven los PDF de extractos y facturas sin redactar. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Mercury Multiorg MCP
Mercury Multiorg MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Mercury Multiorg MCP
B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Mercury Multiorg MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Mercury Multiorg MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-value 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MERCURY_TOKEN_ACME_MAIN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Mercury Multiorg MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user mercury-multiorg --env MERCURY_TOKEN_ACME_MAIN=your-value -- uvx mercury-multiorg-mcp --entities your-valueCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Mercury Multiorg MCP en la lista como conectado
Usa Mercury Multiorg MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Mercury Multiorg MCP o muestra una herramienta de Mercury Multiorg MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Host de la API de Mercury. Permitidos sin indicadores adicionales: https://api.mercury.com, https://api-sandbox.mercury.com (con tokens de sandbox) o un mock de loopback. MERCURY_ALLOW_DOCUMENTS Establezca en true para registrar get_statement_pdf y get_invoice_pdf, que devuelven los PDF de extractos y facturas sin redactar. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Mercury Multiorg MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Mercury Multiorg MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "mercury-multiorg": { "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MERCURY_TOKEN_ACME_MAIN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Mercury Multiorg MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
~/.cursor/mcp.json
Pega esta configuración, completa los valores vacíos y guarda
{
"mcpServers": {
"mercury-multiorg": {
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}En la configuración de Mercury Multiorg MCP, MERCURY_TOKEN_ACME_MAIN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Mercury Multiorg MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Mercury Multiorg MCP o muestra una herramienta de Mercury Multiorg MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Host de la API de Mercury. Permitidos sin indicadores adicionales: https://api.mercury.com, https://api-sandbox.mercury.com (con tokens de sandbox) o un mock de loopback. MERCURY_ALLOW_DOCUMENTS Establezca en true para registrar get_statement_pdf y get_invoice_pdf, que devuelven los PDF de extractos y facturas sin redactar. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Mercury Multiorg MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Mercury Multiorg MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "mercury-multiorg": { "type": "stdio", "command": "uvx", "args": [ "mercury-multiorg-mcp", "--entities", "your-value" ], "env": { "MERCURY_TOKEN_ACME_MAIN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MERCURY_TOKEN_ACME_MAIN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Mercury Multiorg MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
MCP: Open User Configuration
Pega esta configuración, completa los valores vacíos y guarda
{
"servers": {
"mercury-multiorg": {
"type": "stdio",
"command": "uvx",
"args": [
"mercury-multiorg-mcp",
"--entities",
"your-value"
],
"env": {
"MERCURY_TOKEN_ACME_MAIN": "your-value"
}
}
}
}En la configuración de Mercury Multiorg MCP, MERCURY_TOKEN_ACME_MAIN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Mercury Multiorg MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Mercury Multiorg MCP o muestra una herramienta de Mercury Multiorg MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MERCURY_ENTITIES_FILE Alternative to --entities: path to the entity registry YAML. Ignored when --entities is passed.MERCURY_API_BASE Host de la API de Mercury. Permitidos sin indicadores adicionales: https://api.mercury.com, https://api-sandbox.mercury.com (con tokens de sandbox) o un mock de loopback. MERCURY_ALLOW_DOCUMENTS Establezca en true para registrar get_statement_pdf y get_invoice_pdf, que devuelven los PDF de extractos y facturas sin redactar. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
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 secreto obligatorio envMERCURY_ENTITIES_FILE envMERCURY_API_BASE envMERCURY_ALLOW_DOCUMENTS envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub dkaleganov, dueña del repo
Último cambio de código: hace 2 meses
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mercury-multiorg-mcp@0.1.6
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/dkaleganov-mercury-multiorg-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MERCURY_TOKEN_ACME_MAIN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 2 meses, y la última versión (0.1.6) llegó al registro hace 2 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
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
| Este Mercury Multiorg MCP | SolidInvoice | Signal8 | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | En la nube o instalado en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | En la nube o instalado en tu equipo |
| Necesita clave | Sí | No | Sí | No | No | Sí |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/6 | 5/5 | 4/4 | 4/4 | 5/5 |
| Licencia | MIT | MIT | MIT | NOASSERTION | MIT | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
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