Skip to content
MCP server

CashPilot

Monitor passive-income and DePIN earnings and control CashPilot services from an AI client

Runs locallyStatus and history
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-mcp

Add 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)Required
  • CASHPILOT_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.Required
  • CASHPILOT_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 listenerRequired
  • CASHPILOT_URLCashPilot instance URL (e.g. http://localhost:8080)Required
  • CASHPILOT_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.Required
  • CASHPILOT_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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government