About Ccstory
Ccstory is an MCP server in the Developer Tools category: claude Code usage recap with narrative. ccusage tells you the bill, ccstory tells the story.
Install
From source
git clone https://github.com/atomchung/ccstoryThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
compare_to_previous(window, classify, agent)Active-hours and cost deltas vs. the immediately preceding same-length window, with current/previous usage coverage and unpriced models.
Parameters not published.
get_goal_activity_history(weeks, agent)The same sanitized JSON object as `ccstory goal-history`: 4 completed local ISO weeks by default (max 24, invalid counts rejected), every effective goal including zero activity, exclusive/shared/unattributed hours, unavailable activity coverage, source fingerprint, and explicit accounting/disclaimer semantics. Requires configured or managed GoalContext.
Parameters not published.
get_recap(window, classify, allow_llm, agent)Totals, per-category active hours + narrative + a `children` per-project breakdown (name + hours), legacy overall narrative, additive deterministic `top_focus_projection`, optional current goal-activity projection, top 5 sessions with `summary_evidence.status`, cost, usage coverage, unpriced models, and classification-source coverage.
Parameters not published.
get_trend(period, count, classify, agent)Per-period series over the last `count` weeks/months (oldest first): active hours, cost, per-category hours, usage coverage, unpriced models, and classification-source coverage. `count` clamped to 1..24.
Parameters not published.
list_categories()The bucket rules ccstory classifies sessions into (user + built-in defaults).
Parameters not published.
Ask AI
✦
Ask AI about Ccstory
Powered by Claude · Grounded in docs
I know everything about Ccstory. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.