io.github.GeiserX/cashpilot-mcp

Official

by GeiserX · Go

MCP server for CashPilot — monitor passive income, bandwidth sharing, and DePIN earnings

io.github.GeiserX/cashpilot-mcp MCP Server

This Model Context Protocol (MCP) server for CashPilot monitors passive income, bandwidth sharing, and DePIN earnings. It is packaged as an MCP server and uses JSON-RPC and stdio for communication, and it is implemented in Go for self-hosted deployments.

🛠️ Key Features

Monitor passive income
Track bandwidth sharing
Observe DePIN earnings
MCP server using JSON-RPC over stdio
Implemented in Go

🚀 Use Cases

Homelab dashboards for CashPilot metrics
Fleet-management style monitoring for DePIN-related earnings
Integrations involving MCP and LLM workflows

⚡ Developer Benefits

Tooling and integration oriented around MCP
JSON-RPC compatibility for structured communication
Self-hosted operation
Container-management and Docker topics

⚠️ Limitations

Server description provided does not include specific tool names or counts, or full operational details beyond the monitoring scope.

Topics

bandwidth-sharingcashpilotcontainer-managementdepinearningsfleet-managementhomelabjson-rpcmcp-servermodel-context-protocolpassive-incomeself-hostedstdioclaude-desktopearnappearnings-trackerhoneygainmcp-toolsmysteriumtraffmonetizer

README.md4 KBView on GitHub

cashpilot-mcp

A tiny bridge that exposes any CashPilot instance as an MCP server, enabling LLMs to monitor passive income earnings, manage services, and control fleet workers.

It talks to your own CashPilot instance with its admin API key, over HTTP or stdio.

Features

Read-only resources for earnings, deployed services, the catalog, fleet status, workers, health scores and collector alerts (cashpilot://earnings/summary, cashpilot://fleet/summary, ...).
Tools to query daily and historical earnings, read service logs, and start, stop, restart, deploy or remove services.
trigger_collection runs an earnings collection across all services now; get_compose returns a service's Docker Compose definition.
One JSON-RPC endpoint (/mcp) over HTTP, or stdio with TRANSPORT=stdio.
Listens on 127.0.0.1:8081 by default; MCP_AUTH_TOKEN adds bearer auth when you expose it.
Ships as a Docker image, an npm package (npx cashpilot-mcp) and multi-arch Go binaries.

Quick start

json

{
  "mcpServers": {
    "cashpilot": {
      "command": "npx",
      "args": ["-y", "cashpilot-mcp"],
      "env": {
        "CASHPILOT_URL": "http://localhost:8080",
        "CASHPILOT_API_KEY": "<your CASHPILOT_ADMIN_API_KEY>"
      }
    }
  }
}

The key is CashPilot's admin API key, not the fleet key. Docker Compose, the HTTP server and local builds are in Getting started.

Documentation

Getting started: Docker Compose, npm, local build
Configuration: environment variables and MCP client configuration
Usage: resources and tools
Development: testing, contributing, credits
Related projects: the family and registry listings

CashPilot, the passive income fleet manager this server talks to.

License

GPL-3.0-or-later

Install

Configuration

Environment variables

CASHPILOT_URLrequired

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

CASHPILOT_API_KEYrequiredsecret

CashPilot admin API key (CASHPILOT_ADMIN_API_KEY from your CashPilot instance — NOT the fleet key)

TRANSPORTrequireddefault stdio

Runs the image on stdio instead of its default HTTP listener

Add to VS Code Add to Cursor

claude_desktop_config.json