CashPilot
Monitor passive-income and DePIN earnings and control CashPilot services from an AI client
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.2
- Listing updated
- 2 days ago
About CashPilot
CashPilot is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
CashPilot-MCP is a small bridge to your own CashPilot instance, the fleet manager for passive-income and DePIN services. It uses the instance URL and an API key and works over stdio or Streamable HTTP. You can ask for earnings totals for today, this month or all time, per-service balances with cashout eligibility, a daily series for up to 365 days, and health scores per service.
It also manages the fleet. Tools list deployed and deployable services, workers and collector alerts, show container logs, and can start, stop, restart, deploy or remove a service on a chosen worker, trigger a collection or export a Docker Compose file per architecture. Stop, deploy and remove are marked destructive.
A read-only mode registers only tools that change nothing, and the README says to use the read-only key with it and never the fleet key. HTTP mode listens on 127.0.0.1:8081, checks Origin, caps request size and requires MCP_AUTH_TOKEN on non-loopback addresses. The licence is GPL-3.0-or-later.
Install
Run in a terminal
claude mcp add cashpilot-mcp --env CASHPILOT_URL='<CASHPILOT_URL>' --env CASHPILOT_API_KEY='<CASHPILOT_API_KEY>' -- npx -y cashpilot-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"cashpilot-mcp": {
"command": "npx",
"args": [
"-y",
"cashpilot-mcp"
],
"env": {
"CASHPILOT_URL": "<CASHPILOT_URL>",
"CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cashpilot-mcp": {
"command": "npx",
"args": [
"-y",
"cashpilot-mcp"
],
"env": {
"CASHPILOT_URL": "<CASHPILOT_URL>",
"CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cashpilot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cashpilot-mcp"
],
"env": {
"CASHPILOT_URL": "<CASHPILOT_URL>",
"CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cashpilot-mcp": {
"command": "npx",
"args": [
"-y",
"cashpilot-mcp"
],
"env": {
"CASHPILOT_URL": "<CASHPILOT_URL>",
"CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cashpilot-mcp": {
"command": "npx",
"args": [
"-y",
"cashpilot-mcp"
],
"env": {
"CASHPILOT_URL": "<CASHPILOT_URL>",
"CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
}
}
}
}Configuration
CASHPILOT_URLCashPilot instance URL (e.g. http://localhost:8080)RequiredCASHPILOT_API_KEYCashPilot API key: the admin key (CASHPILOT_ADMIN_API_KEY) for full control, or the read-only key (CASHPILOT_READONLY_API_KEY) together with CASHPILOT_READ_ONLY=1. Not the fleet key.RequiredCASHPILOT_READ_ONLYSet to true (or 1) to register only the tools that change nothing (no start, stop, restart, deploy, remove or collection)TRANSPORTRuns the image on stdio instead of its default HTTP listenerRequiredCASHPILOT_URLCashPilot instance URL (e.g. http://localhost:8080)RequiredCASHPILOT_API_KEYCashPilot API key: the admin key (CASHPILOT_ADMIN_API_KEY) for full control, or the read-only key (CASHPILOT_READONLY_API_KEY) together with CASHPILOT_READ_ONLY=1. Not the fleet key.RequiredCASHPILOT_READ_ONLYSet to true (or 1) to register only the tools that change nothing (no start, stop, restart, deploy, remove or collection)
Tools this server provides (18)
Taken from the project documentation; the running server may differ.
- get_earnings_summary
- Totals for today, this month and all time.
- get_earnings_breakdown
- Balance and cashout eligibility per service.
- get_earnings_daily
- One earnings total per day.
- get_earnings_history
- Earning records by period.
- list_deployed_services
- Lists what runs where.
- list_available_services
- Lists the deployable catalogue.
- get_fleet_summary
- Workers and containers online and total.
- list_workers
- Lists worker ids.
- get_health_scores
- Health per service.
- get_collector_alerts
- Errors from the last collection.
- get_service_logs
- Latest container log lines.
- get_compose
- Docker Compose file for an architecture.
- trigger_collection
- Collects earnings now.
- start_service
- Starts a container.
- restart_service
- Restarts a container.
- stop_service
- Stops a container.
- deploy_service
- Deploys or redeploys a service.
- remove_service
- Removes a deployment.
What it does
- Earnings reporting
- Totals, per-service balances, daily series and history.
- Fleet overview
- Workers, containers, health scores and collector alerts.
- Service control
- Start, stop, restart, deploy and remove services.
- Read-only mode
- Registers only tools that change nothing.
- Compose export
- Docker Compose file for amd64, arm64 or arm.
- Guarded HTTP mode
- Origin checks, size caps and a token off loopback.
Good for
- Check how much the fleet earned this month
- Find which service has a poor health score
- Restart a stalled container from a chat
- See which services are eligible for cashout
- Export a Compose file for a new worker
Pricing
Open source
GPL-3.0-or-later
CashPilot FAQ
Which key should I use?
The admin key for full control, or the read-only key with CASHPILOT_READ_ONLY set. Never the fleet key.
Can it be made safe to explore?
Yes. Read-only mode hides start, stop, restart, deploy, remove and collection tools.
What licence is it?
GPL-3.0-or-later.
Do I need multiple workers?
No, but with more than one online, service tools need a worker_id from list_workers.
Is CashPilot free?
Yes. CashPilot is open source, so you can use and self-host it for free.
How do I add CashPilot to Claude Code?
Run this command in your terminal: claude mcp add cashpilot-mcp --env CASHPILOT_URL='<CASHPILOT_URL>' --env CASHPILOT_API_KEY='<CASHPILOT_API_KEY>' -- npx -y cashpilot-mcp
What are the best alternatives to CashPilot?
The closest alternatives to CashPilot are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to CashPilot

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government