geiserx avatar

CashPilot

geiserx/cashpilot-mcp

Bridges your CashPilot passive income dashboard to Claude, exposing earnings data, service management, and fleet worker controls through MCP resources and tools. Query daily earnings and historical trends, restart or deploy bandwidth sharing services like EarnApp or Honeygain, trigger collection runs, and monitor worker health scores. Resources provide read-only views of earnings summaries, service catalogs, and fleet status via URIs like cashpilot://earnings/summary. Tools let you take action with methods like restart_service, deploy_service, and get_service_logs. Built in Go, supports both stdio and HTTP transports with optional bearer auth. If you're running multiple passive income nodes and want LLM-assisted monitoring and control, this turns CashPilot's admin API into something Claude can work with directly.

GitHub stars
3
tools
18
auth
Secret needed
transport
STDIO
env vars
4
last updated
Nov 12, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

get_earnings_summaryTotals: today, this month, all time

Totals: today, this month, all time

No parameter schema in public metadata yet.

get_earnings_breakdownBalance and cashout eligibility per service

Balance and cashout eligibility per service

No parameter schema in public metadata yet.

get_earnings_dailyOne total per day, 1 to 365 days

One total per day, 1 to 365 days

No parameter schema in public metadata yet.

get_earnings_historyRecords for a week, month, year or all

Records for a week, month, year or all

No parameter schema in public metadata yet.

list_deployed_servicesWhat runs where, with status and resources

What runs where, with status and resources

No parameter schema in public metadata yet.

list_available_servicesDeployable catalog with the env keys each needs

Deployable catalog with the env keys each needs

No parameter schema in public metadata yet.

get_fleet_summaryWorkers and containers, online and total

Workers and containers, online and total

No parameter schema in public metadata yet.

list_workersWorker ids for `worker_id`

Worker ids for `worker_id`

No parameter schema in public metadata yet.

get_health_scoresHealth per service over 1 to 90 days

Health per service over 1 to 90 days

No parameter schema in public metadata yet.

get_collector_alertsErrors from the last earnings collection

Errors from the last earnings collection

No parameter schema in public metadata yet.

get_service_logsLatest container log lines (untrusted content)

Latest container log lines (untrusted content)

No parameter schema in public metadata yet.

get_composedocker-compose.yml for amd64, arm64 or arm

docker-compose.yml for amd64, arm64 or arm

No parameter schema in public metadata yet.

trigger_collectionCollect earnings now, in the background

Collect earnings now, in the background

No parameter schema in public metadata yet.

start_serviceStart a container

Start a container

No parameter schema in public metadata yet.

restart_serviceRestart a container

Restart a container

No parameter schema in public metadata yet.

stop_serviceStop a container; it stops earning

Stop a container; it stops earning

No parameter schema in public metadata yet.

deploy_serviceDeploy or redeploy with env, hostname, instances

Deploy or redeploy with env, hostname, instances

No parameter schema in public metadata yet.

remove_serviceRemove a deployment; volumes are kept

Remove a deployment; volumes are kept

No parameter schema in public metadata yet.

Sponsors

Configuration

CASHPILOT_URL*

CashPilot instance URL (e.g. http://localhost:8080)

CASHPILOT_API_KEY*secret

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

CASHPILOT_READ_ONLYdefault: false

Set to true (or 1) to register only the tools that change nothing (no start, stop, restart, deploy, remove or collection)

TRANSPORT*default: stdio

Runs the image on stdio instead of its default HTTP listener

Readme

Details

Repository
github.com/geiserx/cashpilot-mcp
Website
github.com/GeiserX/cashpilot-mcp
Package
cashpilot-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from geiserx