# CashPilot

> CashPilot is an open-source MCP server for finance and payments. Monitor passive-income and DePIN earnings and control CashPilot services from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/geiserx/cashpilot-mcp
- **MCP Registry name:** io.github.GeiserX/cashpilot-mcp
- **Categories:** finance and payments, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add cashpilot-mcp --env CASHPILOT_URL='<CASHPILOT_URL>' --env CASHPILOT_API_KEY='<CASHPILOT_API_KEY>' -- npx -y cashpilot-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cashpilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cashpilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "cashpilot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cashpilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cashpilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

- [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.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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