Stars Cash Flow — MCP server, AI skill & Hermes tool

Buy and manage real Telegram Stars CPA / SMM orders — channel subscribers, boosts and bot starts — straight from Claude, ChatGPT, or any AI agent.

CI npm License: MIT MCP

Drive the Stars Cash Flow reseller API from any AI agent. Stars Cash Flow is a CPA exchange for real Telegram actions — channel subscribers, boosts and bot starts fulfilled by verified real users, not bots. The API is JustAnotherPanel / Perfect-Panel compatible, so it drops into any existing SMM-panel integration.

One API contract, three first-class surfaces:

Highlights

• 🤝 Drop-in compatible — JustAnotherPanel / Perfect-Panel API; swap URL + key.
• 🔒 Money-safe by design — ordering and cancelling are two-step; nothing spends or refunds without explicit confirmation.
• 🧩 Works everywhere — MCP for Claude, an OpenAPI action for ChatGPT, a skill + zero-dependency CLI for Hermes and any shell.
• 📘 Fully documented — API reference, quickstart, FAQ, error reference, runnable examples.
• ✅ Tested & typed — TypeScript client, vitest suite, CI on Node 18/20/22, published with provenance.

Documentation

• 📘 API reference — every action, field and guarantee
• 🚀 Quickstart — set up each surface in minutes
• ❓ FAQ — common questions
• ⚠️ Error reference — every error message and fix
• 🧪 Examples — runnable curl / Python / Node

The API in 30 seconds

POST https://api-stars.ros.media/api/v2 — form-encoded, dispatched on action:

Get an API key from @StarsCashFlowbot → Reseller. Everything except services needs the key; the key holds a USD balance. Rate limit: 60 req/min/key.

🔴 Money safety

add debits real USD. Every surface here prices the order first and refuses to spend without explicit confirmation:

• MCP — create_order and cancel_order are two-step: the first call returns a preview (cost estimate / what would be cancelled); they only act when called again with confirm: true.
• CLI — order / cancel print an estimate and do nothing unless --confirm.
• Skill — instructs the agent to price, show the cost, and get a "yes" first.

Never hardcode or print the key — read it from STARS_CASH_FLOW_API_KEY.

Install — MCP server

Once published:

npx -y @rosmedia/stars-cash-flow-mcp

Or from source:

git clone https://github.com/govRosMedia/stars-cash-flow-mcp.git
cd stars-cash-flow-mcp
npm install && npm run build

Register in an MCP host (claude_desktop_config.json / .mcp.json):

{
  "mcpServers": {
    "stars-cash-flow": {
      "command": "npx",
      "args": ["-y", "@rosmedia/stars-cash-flow-mcp"],
      "env": {
        "STARS_CASH_FLOW_API_KEY": "your-key",
        "STARS_CASH_FLOW_API_BASE": "https://api-stars.ros.media/api/v2"
      }
    }
  }
}

Tools: list_services, get_balance, create_order (confirm-gated), order_status, cancel_order.

See the Quickstart for ChatGPT and Hermes setup.

Use the typed client directly

import { StarsCashFlowClient } from "@rosmedia/stars-cash-flow-mcp";

const client = new StarsCashFlowClient(); // reads STARS_CASH_FLOW_API_KEY
const services = await client.listServices();
const cost = StarsCashFlowClient.cost(services[0], 1000); // USD

Development

npm install
npm run build      # tsc → dist/
npm test           # vitest
npm run typecheck  # tsc --noEmit

CI runs build + tests on Node 18/20/22. See CONTRIBUTING.md.

License

MIT © Stars Cash Flow