mcpField
C
cost-summary

cost-summary

github.com/ruvnetAgent workflows80.0k683 installsUpdated today
Repository

About cost-summary

cost-summary is a script-based interface for retrieving cost state from cost-tracking and federation-spend sources. It is intended for plugins, scripts, dashboards, and bots that need Markdown or contract-based JSON output; MCP tool registration is deferred.

Key features

  1. 01Aggregates multiple cost sources
  2. 02Provides stable JSON output
  3. 03Supports Markdown output
  4. 04Configurable namespaces and format

Use cases

  1. 01Read cost state from another plugin
  2. 02Feed a dashboard or Slackbot
  3. 03Get a consolidated cost snapshot

MCP support

The project explicitly defers MCP tool registration. It exposes cost data through a command-line script with Markdown or JSON output.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill cost-summary

After installing, type/cost-summaryin Claude Code to confirm it loaded.

Details

From the project README

Cost Summary

A stable single-call interface that other plugins / scripts / dashboards can shell out to and parse. ADR-0002 considered exposing cost_report / cost_summary as proper MCP tools but deferred that — adding MCP tools requires modifying @claude-flow/cli source, out of scope for plugin-local work. This script is the equivalent: same data, exposed via a stdout JSON contract.

When to use

  • Another plugin needs a snapshot of cost state — it shells out to summary.mjs --format json and parses.
  • A dashboard / Slackbot fetches a one-line cost rollup.
  • Quick "where am I right now?" view that pulls from every cost-tracker source (cost-tracking + federation-spend).

Output contract (JSON, stable)

{
  "exportedAt": "<ISO>",
  "total_cost_usd": 1546.36,
  "sessionCount": 1,
  "conversationCount": 1,
  "byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "cost_usd": 1546.36,
      "messages": 1597,
      "input_tokens": 3090,
      "output_tokens": 3295940,
      "cache_creation_input_tokens": 10659599,
      "cache_read_input_tokens": 732833690
    }
  },
  "topSession": {
    "sessionId": "1dba3b8c-...",
    "total_cost_usd": 1546.36,
    "messageCount": 1597
  },
  "budget": {
    "budget_usd": 2500.00,
    "setAt": "<ISO>",
    "spent_usd": 1546.36,
    "utilization": 0.6185,
    "level": "INFO"
  },
  "federation": {
    "eventCount": 0,
    "peerCount": 0,
    "totalUsd24h": 0
  }
}

Steps

# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs

# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json

Optional env: SUMMARY_NAMESPACE=cost-tracking, SUMMARY_FED_NAMESPACE=federation-spend, SUMMARY_FORMAT=json.

Cross-references

  • cost-report — narrative report (per-agent / per-model lens; uses same data)
  • cost-export — pushes to Prometheus / webhook (this skill is pull-style; export is push-style)
  • ADR-0002 §"Decision" — explicitly defers proper MCP-tool registration to a future ADR

Comments

Markdown supported