sophtron-mcp

A Claude Desktop MCP server for querying bank accounts, credit cards, and transactions via Sophtron's financial data API.

Patched for Claude — forked from sophtron/chagpt-mcp which was built exclusively for ChatGPT. This version replaces the OpenAI-specific transport, auth, and widget code with a standard stdio MCP server that works with Claude Desktop, Claude Code, and any MCP-compatible client.

Free alternative to requiring a paid budgeting app (Monarch Money, YNAB, etc.) as middleware. Sophtron provides free API access for individual use, connecting directly to 12,000+ financial institutions via their data aggregation layer.

Setup

1. Get Sophtron credentials

Sign up at sophtron.com and get your User ID and Access Key.

2. Install

git clone https://github.com/312-dev/sophtron-mcp.git
cd sophtron-mcp
npm install
npm run build

3. Configure credentials

cp .env.example .env
# Edit .env with your Sophtron User ID and Access Key

4. Add to Claude Desktop

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sophtron": {
      "command": "node",
      "args": ["/path/to/sophtron-mcp/dist/index.js"],
      "env": {
        "SOPHTRON_USER_ID": "your-user-id",
        "SOPHTRON_ACCESS_KEY": "your-access-key"
      }
    }
  }
}

Or for Claude Code, add to ~/.claude.json under mcpServers:

{
  "sophtron": {
    "type": "stdio",
    "command": "node",
    "args": ["/path/to/sophtron-mcp/dist/index.js"],
    "env": {
      "SOPHTRON_USER_ID": "your-user-id",
      "SOPHTRON_ACCESS_KEY": "your-access-key"
    }
  }
}

5. Connect your bank

Bank connections are managed through Sophtron's infrastructure. To link your accounts:

1. Use the Sophtron widget through their ChatGPT integration or web portal to connect your bank

2. Once connected, this MCP server can query all your account data from Claude

Related MCP server: simplefin

Available tools

How it works

This server communicates with Sophtron's REST API using HMAC-SHA256 signed requests. Your credentials never leave your machine — they're used locally to sign API calls.

Data is cached locally in ~/.sophtron-mcp/:

• customer.json — your Sophtron customer ID

• connections.json — saved bank connection references

What changed from the original

The upstream repo is built for ChatGPT with:

• OpenAI-specific widget rendering (window.openai.setWidgetState)

• OAuth2 JWT authentication flow

• Express HTTP transport only

• In-memory connection storage

• structuredContent and openai/* metadata

This fork replaces all of that with:

• Standard MCP stdio transport (works with any MCP client)

• Direct HMAC API authentication (no OAuth needed)

• Disk-based persistence

• Clean tool definitions without vendor lock-in

License

MIT