Mercury MCP Server

MCP Server for Mercury Banking API. Supports both stdio (for Docker) and HTTP transports.

Usage

Claude Desktop and Cursor

{
  "mcpServers": {
    "mercury": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MERCURY_API_KEY",
        "ghcr.io/fyko/mercury-mcp-server"
      ],
      "env": {
        "MERCURY_API_KEY": "replace_me"
      }
    }
  }
}

Server Mode

Run the server normally (without -i flag or with a tty):

docker run -e MERCURY_API_KEY=your-key -e MCP_API_KEY=your-auth-key -p 9236:9236 ghcr.io/fyko/mercury-mcp-server

or locally:

# create .env, bun autoloads it
MERCURY_API_KEY=your-key
MCP_API_KEY=your-auth-key
PORT=9236

bun start

The server auto-detects which mode to use based on whether stdin is a tty.

To use the server in Cursor:

{
  "mcpServers": {
    "mercury": {
      "url": "https://whatever.example.com/mcp",
      "headers": {
        "Authorization": "Bearer MCP_API_KEY"
      }
    }
  }
}

Tools

• list-accounts - list all mercury accounts
• get-account-transactions - get transactions for an account

Building

docker build -t mercury-mcp-server .

Development

bun install
bun run dev # hot reloading