Appearance
Effort tracking
There is no /api/v1/effort REST endpoint. Effort data is the actuals side of Flowstate: what people actually worked on, captured from your PMS or entered manually. You read it through the MCP server or in the app under Delivery → Effort Tracking.
New to Flowstate?
See Effort tracking for the conceptual model: weekly grids, approval stages, and PMS sync.
Effort vs allocation
| Concept | Source | Access |
|---|---|---|
| Allocation | Forecast, what you planned | /assignments REST endpoints |
| Effort | Actual, what happened | MCP tools (this page) and the app |
Effort is recorded in weekly periods. People (or PMS sync) submit effort reports per week. Submitted effort is costed using each worker's salary or rate, which is what feeds capitalisation and variance reporting.
MCP tools for effort data
The MCP server exposes six read tools for effort. Each takes an optional date window (startDate, endDate).
| Tool | What it returns |
|---|---|
get_project_effort | Per-resource effort breakdown for a project: FTE and cost from effort tracking, not forecast allocations |
get_team_effort | Per-project effort breakdown for a team |
get_unattributed_effort | Effort not linked to any Flowstate project, so you can fix project attribution for CapEx reporting |
get_uncosted_effort | Workers with real effort in the period but no resolvable salary or rate, which distorts cost-weighted CapEx |
get_effort_gaps | People active in the period whose effort never reaches the capitalisation split: no tracked effort at all, or tracked effort with no report filed |
get_submission_leaderboard | The on-time vs late effort-report submission leaderboard for the period, per submitter |
Tool calls inherit the calling user's Flowstate permissions. Cost figures require a financial view permission. Without it, FTE data still returns and cost fields are withheld.
Where to go next
- MCP server: protocol reference and the full tool catalogue.
- Effort tracking: the conceptual model, including approval workflows.
- Assignments: the planned allocations these actuals get compared against.
- Variance Tracking: how variance between effort and allocation rolls up into financial review.