# TreasuryOS

> TreasuryOS is an open-source MCP server for finance and payments. Cash, covenant, FX and loan-readiness analysis for small businesses. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/gpbk-stuy/treasury-mcp-os
- **MCP Registry name:** io.github.GPBK-STUY/treasury-mcp-os
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add treasury-mcp-os -- uvx treasury-mcp-os
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_data_format`: Describe the data format to pass into the analysis tools.

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/treasuryos
