CashPilot MCP — Gerenciador de Renda Passiva via MCP
GeiserX/cashpilot-mcp
Controle CashPilot via Claude e outros LLMs com recursos e ferramentas MCP
Ver no GitHubMCP Server que integra qualquer instância CashPilot com LLMs para monitoramento de ganhos passivos, gerenciamento de serviços e controle de workers em frotas. Oferece recursos somente leitura para auditoria de earnings e ferramentas para automação de deployments e coletas de dados.
Instalação
npx convez-ai GeiserX/cashpilot-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar ganhos passivos e histórico de earnings em tempo real
- Automatizar deploy e reinicialização de serviços via Claude
- Auditar saúde de fleet workers e scores de performance
Veredito

MCP Server sólido (Go 1.24, oficial registry) para ecossistemas CashPilot — bem documentado e com bom suporte a recursos + ferramentas. Recomendado para times que operam renda passiva e precisam de automação via LLMs.
README
A tradução para o português deste README ainda está na fila.
What you get
| Type | What for | MCP URI / Tool id |
|---|---|---|
| Resources | Browse earnings, services, fleet status, and health scores read-only | cashpilot://earnings/summarycashpilot://earnings/breakdowncashpilot://services/deployedcashpilot://services/catalogcashpilot://fleet/summarycashpilot://workerscashpilot://health/scorescashpilot://collector-alerts |
| Tools | Query earnings, manage services, and trigger collection | get_earnings_dailyget_earnings_historyget_service_logsrestart_servicestop_servicestart_servicedeploy_serviceremove_servicetrigger_collectionget_compose |
Everything is exposed over a single JSON-RPC endpoint (/mcp).
LLMs / Agents can: initialize -> readResource -> listTools -> callTool ... and so on.
Quick-start (Docker Compose)
services:
cashpilot-mcp:
image: drumsergio/cashpilot-mcp:latest
ports:
- "127.0.0.1:8081:8081"
environment:
- CASHPILOT_URL=http://cashpilot:8080
- CASHPILOT_API_KEY=<your-CASHPILOT_ADMIN_API_KEY>
Security note: The HTTP transport listens on
127.0.0.1:8081by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.
Install via npm (stdio transport)
npx cashpilot-mcp
Or install globally:
npm install -g cashpilot-mcp
cashpilot-mcp
This downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one published release.
Local build
git clone https://github.com/GeiserX/cashpilot-mcp
cd cashpilot-mcp
# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env
go run ./cmd/server
Configuration
| Variable | Default | Description |
|---|---|---|
CASHPILOT_URL | http://localhost:8080 | CashPilot instance URL (without trailing /) |
CASHPILOT_API_KEY | (required) | Admin API key (CASHPILOT_ADMIN_API_KEY from your CashPilot instance — NOT the fleet key) |
LISTEN_ADDR | 127.0.0.1:8081 | HTTP listen address (Docker sets 127.0.0.1:8081) |
MCP_AUTH_TOKEN | (empty) | Bearer token for HTTP transport auth. Required when LISTEN_ADDR is not loopback |
TRANSPORT | (empty = HTTP) | Set to stdio for stdio transport |
Put them in a .env file (from .env.example) or set them in the environment.
Testing
Tested with Inspector and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.
Example configuration for client LLMs
{
"schema_version": "v1",
"name_for_human": "CashPilot-MCP",
"name_for_model": "cashpilot_mcp",
"description_for_human": "Monitor passive income earnings, manage bandwidth-sharing services, and control fleet workers via CashPilot.",
"description_for_model": "Interact with a CashPilot instance that manages passive income services. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with cashpilot://. Use listTools to discover available actions and callTool to execute them.",
"auth": {
"type": "bearer",
"token": "<your-MCP_AUTH_TOKEN>"
},
"api": {
"type": "jsonrpc-mcp",
"url": "http://localhost:8081/mcp",
"init_method": "initialize",
"session_header": "Mcp-Session-Id"
},
"contact_email": "acsdesk@protonmail.com",
"legal_info_url": "https://github.com/GeiserX/cashpilot-mcp/blob/main/LICENSE"
}
Credits
CashPilot -- passive income fleet management dashboard
MCP-GO -- modern MCP implementation
GoReleaser -- painless multi-arch releases
Maintainers
Contributing
Feel free to dive in! Open an issue or submit PRs.
CashPilot-MCP follows the Contributor Covenant Code of Conduct.
Other MCP Servers by GeiserX
- duplicacy-mcp — Backup health monitoring
- genieacs-mcp — TR-069 device management
- lynxprompt-mcp — AI configuration blueprints
- pumperly-mcp — Fuel and EV charging prices
- telegram-archive-mcp — Telegram message archive
Related Projects
| Project | Description |
|---|---|
| CashPilot | Self-hosted passive income platform with web UI for setup and earnings tracking |
| CashPilot-android | Android monitoring agent for CashPilot passive income apps |
| cashpilot-ha | Home Assistant custom integration for CashPilot passive income monitoring |
| n8n-nodes-cashpilot | n8n community node for CashPilot passive income monitoring |