Skip to content
MCP server

TreasuryOS

Cash, covenant, FX and loan-readiness analysis for small businesses

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.2.0
Listing updated
today

Similar MCP servers

About TreasuryOS

TreasuryOS is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The engine behind this server scores loan readiness from 0 to 100 across six categories: personal credit, business credit, cash position, working capital, existing debt and documentation. The same engine also feeds a business-owner Streamlit app and a bank relationship-manager dashboard, so the MCP tools are one of three entry points.

The nine analysis tools cover cash position aggregation, idle cash scanning, cash flow forecasting, working capital, credit report parsing, credit position assessment, covenant monitoring, FX exposure and payment optimisation. Out of the box it analyses a bundled demo company, Apex Manufacturing Corp. To analyse a real business, the agent calls get_data_format and passes CSV text or row objects into a tool's data argument; the README says that data is used for the call only and not stored. You can also point TREASURY_DATA_DIR at a folder of client CSVs.

It installs with uvx or from PyPI, runs over stdio, and can also serve Streamable HTTP. The app can ingest CSV, Excel, Word and PDF files. The repository is MIT licensed, and the author lists five years in commercial banking.

Install

Run in a terminal

claude mcp add treasury-mcp-os -- uvx treasury-mcp-os

Add to claude_desktop_config.json

{
  "mcpServers": {
    "treasury-mcp-os": {
      "command": "uvx",
      "args": [
        "treasury-mcp-os"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "treasury-mcp-os": {
      "command": "uvx",
      "args": [
        "treasury-mcp-os"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "treasury-mcp-os": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "treasury-mcp-os"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "treasury-mcp-os": {
      "command": "uvx",
      "args": [
        "treasury-mcp-os"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "treasury-mcp-os": {
      "command": "uvx",
      "args": [
        "treasury-mcp-os"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TREASURY_DATA_DIRFolder of client CSVs to analyze. Defaults to the bundled demo company.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_data_format
Describe the data format to pass into the analysis tools.

What it does

Loan readiness score
A 0-100 score across six weighted categories.
Cash and forecast tools
Aggregate cash, spot idle cash and forecast flows.
Covenant monitoring
Track covenant compliance, breaches and warnings.
FX exposure
Scan currency exposure.
Bring your own data
Pass CSV or rows per call; the README says nothing is stored.
Demo dataset
A bundled sample company lets you try the tools first.
Remote HTTP mode
Can serve Streamable HTTP for cloud hosts.

Good for

  • Check whether a small business is ready to apply for a loan
  • Monitor covenant status across a client portfolio
  • Forecast cash over the next 90 days
  • Find idle cash and optimise payment timing

Pricing

Open source

Free, MIT licensed

TreasuryOS FAQ

Does it store my financial data?

The README says data passed to a tool is used for that call only and never stored.

How many tools does it expose?

Ten treasury and credit tools, with nine analysis tools described in the engine.

What is the licence?

MIT.

Can it analyse real company files?

Yes, through the data argument or a TREASURY_DATA_DIR folder of CSVs.

How do I add it to Claude Code?

Run claude mcp add treasury-os -- uvx treasury-mcp-os.

Is TreasuryOS free?

Yes. TreasuryOS is open source, so you can use and self-host it for free.

How do I add TreasuryOS to Claude Code?

Run this command in your terminal: claude mcp add treasury-mcp-os -- uvx treasury-mcp-os

What are the best alternatives to TreasuryOS?

The closest alternatives to TreasuryOS are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers