{
  "markdown": "<p align=\"center\">\n  <img src=\"docs/images/banner.svg\" alt=\"CashPilot MCP banner\" width=\"900\"/>\n</p>\n\n<h1 align=\"center\">CashPilot-MCP</h1>\n\n<p align=\"center\">\n  <a href=\"https://codecov.io/gh/GeiserX/cashpilot-mcp\"><img src=\"https://codecov.io/gh/GeiserX/cashpilot-mcp/graph/badge.svg\" alt=\"codecov\"/></a>\n  <a href=\"https://www.npmjs.com/package/cashpilot-mcp\"><img src=\"https://img.shields.io/npm/v/cashpilot-mcp?style=flat-square&logo=npm\" alt=\"npm\"/></a>\n  <img src=\"https://img.shields.io/badge/Go-1.24-blue?style=flat-square&logo=go&logoColor=white\" alt=\"Go\"/>\n  <a href=\"https://hub.docker.com/r/drumsergio/cashpilot-mcp\"><img src=\"https://img.shields.io/docker/pulls/drumsergio/cashpilot-mcp?style=flat-square&logo=docker\" alt=\"Docker Pulls\"/></a>\n  <a href=\"https://github.com/GeiserX/cashpilot-mcp/stargazers\"><img src=\"https://img.shields.io/github/stars/GeiserX/cashpilot-mcp?style=flat-square&logo=github\" alt=\"GitHub Stars\"/></a>\n  <a href=\"https://github.com/GeiserX/cashpilot-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/GeiserX/cashpilot-mcp?style=flat-square\" alt=\"License\"/></a>\n</p>\n<p align=\"center\">\n  <a href=\"https://registry.modelcontextprotocol.io\"><img src=\"https://img.shields.io/badge/MCP-Official%20Registry-E6522C?style=flat-square\" alt=\"Official MCP Registry\"/></a>\n  <a href=\"https://glama.ai/mcp/servers/GeiserX/cashpilot-mcp\"><img src=\"https://glama.ai/mcp/servers/GeiserX/cashpilot-mcp/badges/score.svg\" alt=\"Glama MCP Server\" /></a>\n  <a href=\"https://mcpservers.org/servers/geiserx/cashpilot-mcp\"><img src=\"https://img.shields.io/badge/MCPServers.org-listed-green?style=flat-square\" alt=\"MCPServers.org\"/></a>\n  <a href=\"https://mcp.so/server/cashpilot-mcp\"><img src=\"https://img.shields.io/badge/mcp.so-listed-blue?style=flat-square\" alt=\"mcp.so\"/></a>\n  <a href=\"https://github.com/toolsdk-ai/toolsdk-mcp-registry\"><img src=\"https://img.shields.io/badge/ToolSDK-Registry-orange?style=flat-square\" alt=\"ToolSDK Registry\"/></a>\n  <a href=\"https://github.com/punkpeye/awesome-mcp-servers#readme\"><img src=\"https://img.shields.io/badge/listed%20on-awesome--mcp--servers-E6522C?style=flat-square\" alt=\"listed on awesome-mcp-servers\"/></a>\n</p>\n\n<p align=\"center\"><strong>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.</strong></p>\n\n---\n\n## What you get\n\n| Type          | What for                                                           | MCP URI / Tool id                |\n|---------------|--------------------------------------------------------------------|----------------------------------|\n| **Resources** | Browse earnings, services, fleet status, and health scores read-only | `cashpilot://earnings/summary`<br>`cashpilot://earnings/breakdown`<br>`cashpilot://services/deployed`<br>`cashpilot://services/catalog`<br>`cashpilot://fleet/summary`<br>`cashpilot://workers`<br>`cashpilot://health/scores`<br>`cashpilot://collector-alerts` |\n| **Tools**     | Query earnings, manage services, and trigger collection             | `get_earnings_daily`<br>`get_earnings_history`<br>`get_service_logs`<br>`restart_service`<br>`stop_service`<br>`start_service`<br>`deploy_service`<br>`remove_service`<br>`trigger_collection`<br>`get_compose` |\n\nEverything is exposed over a single JSON-RPC endpoint (`/mcp`).\nLLMs / Agents can: `initialize` -> `readResource` -> `listTools` -> `callTool` ... and so on.\n\n---\n\n## Quick-start (Docker Compose)\n\n```yaml\nservices:\n  cashpilot-mcp:\n    image: drumsergio/cashpilot-mcp:latest\n    ports:\n      - \"127.0.0.1:8081:8081\"\n    environment:\n      - CASHPILOT_URL=http://cashpilot:8080\n      - CASHPILOT_API_KEY=<your-CASHPILOT_ADMIN_API_KEY>\n```\n\n> **Security note:** The HTTP transport listens on `127.0.0.1:8081` by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.\n\n## Install via npm (stdio transport)\n\n```sh\nnpx cashpilot-mcp\n```\n\nOr install globally:\n\n```sh\nnpm install -g cashpilot-mcp\ncashpilot-mcp\n```\n\nThis downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one [published release](https://github.com/GeiserX/cashpilot-mcp/releases).\n\n## Local build\n\n```sh\ngit clone https://github.com/GeiserX/cashpilot-mcp\ncd cashpilot-mcp\n\n# (optional) create .env from the sample\ncp .env.example .env && $EDITOR .env\n\ngo run ./cmd/server\n```\n\n## Configuration\n\n| Variable           | Default                    | Description                                      |\n|--------------------|----------------------------|--------------------------------------------------|\n| `CASHPILOT_URL`    | `http://localhost:8080`    | CashPilot instance URL (without trailing /)      |\n| `CASHPILOT_API_KEY`| _(required)_               | Admin API key (`CASHPILOT_ADMIN_API_KEY` from your CashPilot instance — NOT the fleet key) |\n| `LISTEN_ADDR`      | `127.0.0.1:8081`           | HTTP listen address (Docker sets `127.0.0.1:8081`) |\n| `MCP_AUTH_TOKEN`   | _(empty)_                  | Bearer token for HTTP transport auth. **Required** when `LISTEN_ADDR` is not loopback |\n| `TRANSPORT`        | _(empty = HTTP)_           | Set to `stdio` for stdio transport               |\n\nPut them in a `.env` file (from `.env.example`) or set them in the environment.\n\n## Testing\n\nTested with [Inspector](https://modelcontextprotocol.io/docs/tools/inspector) and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.\n\n## Example configuration for client LLMs\n\n```json\n{\n  \"schema_version\": \"v1\",\n  \"name_for_human\": \"CashPilot-MCP\",\n  \"name_for_model\": \"cashpilot_mcp\",\n  \"description_for_human\": \"Monitor passive income earnings, manage bandwidth-sharing services, and control fleet workers via CashPilot.\",\n  \"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.\",\n  \"auth\": {\n    \"type\": \"bearer\",\n    \"token\": \"<your-MCP_AUTH_TOKEN>\"\n  },\n  \"api\": {\n    \"type\": \"jsonrpc-mcp\",\n    \"url\":  \"http://localhost:8081/mcp\",\n    \"init_method\": \"initialize\",\n    \"session_header\": \"Mcp-Session-Id\"\n  },\n  \"contact_email\": \"acsdesk@protonmail.com\",\n  \"legal_info_url\": \"https://github.com/GeiserX/cashpilot-mcp/blob/main/LICENSE\"\n}\n```\n\n## Credits\n\n[CashPilot](https://github.com/GeiserX/CashPilot) -- passive income fleet management dashboard\n\n[MCP-GO](https://github.com/mark3labs/mcp-go) -- modern MCP implementation\n\n[GoReleaser](https://goreleaser.com/) -- painless multi-arch releases\n\n## Maintainers\n\n[@GeiserX](https://github.com/GeiserX).\n\n## Contributing\n\nFeel free to dive in! [Open an issue](https://github.com/GeiserX/cashpilot-mcp/issues/new) or submit PRs.\n\nCashPilot-MCP follows the [Contributor Covenant](http://contributor-covenant.org/version/2/1/) Code of Conduct.\n\n## Other MCP Servers by GeiserX\n\n- [duplicacy-mcp](https://github.com/GeiserX/duplicacy-mcp) — Backup health monitoring\n- [genieacs-mcp](https://github.com/GeiserX/genieacs-mcp) — TR-069 device management\n- [lynxprompt-mcp](https://github.com/GeiserX/lynxprompt-mcp) — AI configuration blueprints\n- [pumperly-mcp](https://github.com/GeiserX/pumperly-mcp) — Fuel and EV charging prices\n- [telegram-archive-mcp](https://github.com/GeiserX/telegram-archive-mcp) — Telegram message archive\n\n## Related Projects\n\n| Project | Description |\n|---------|-------------|\n| [CashPilot](https://github.com/GeiserX/CashPilot) | Self-hosted passive income platform with web UI for setup and earnings tracking |\n| [CashPilot-android](https://github.com/GeiserX/CashPilot-android) | Android monitoring agent for CashPilot passive income apps |\n| [cashpilot-ha](https://github.com/GeiserX/cashpilot-ha) | Home Assistant custom integration for CashPilot passive income monitoring |\n| [n8n-nodes-cashpilot](https://github.com/GeiserX/n8n-nodes-cashpilot) | n8n community node for CashPilot passive income monitoring |\n",
  "bytes": 8233,
  "sha": "34416bb91c4cf7de633c25caf91169333e50d47927c1e275049085e29de641ac",
  "repo_slug": "geiserx/cashpilot-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_geiserx_cashpilot_mcp_34557a26/readme"
}