TreasuryOS
Cash, covenant, FX and loan-readiness analysis for small businesses
- 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-osAdd to claude_desktop_config.json
{
"mcpServers": {
"treasury-mcp-os": {
"command": "uvx",
"args": [
"treasury-mcp-os"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"treasury-mcp-os": {
"command": "uvx",
"args": [
"treasury-mcp-os"
]
}
}
}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.

