Returns the runn-mcp server version and effective configuration (base URL, API version, whether a token is configured, dry-run state). Does NOT reveal the token and does NOT call the Runn API.

Verify the token/account by calling GET /me. Returns the authenticated identity.

List projects. Optional case-insensitive name substring filter and archived toggle.

Fetch a single project by ID (GET /projects/{id}).

List project phases. With projectId, lists that project's phases (GET /projects/{id}/phases); without it, lists phases across all projects.

List milestones. With projectId, lists that project's milestones (GET /projects/{id}/milestones); without it, lists milestones across all projects.

List assignments, filterable by project, person, role and date range.

List people. Optionally include placeholders and filter by name/email/externalId.

List placeholders (unfilled roles used to allocate external/contractor work).

List roles (for resolving roleId values used in assignments/actuals).

List workstreams.

List actual (timesheet) entries, filterable by project, person, role, workstream and date range.

By-day plan-vs-actual hours for a project (GET /reports/hours/projects/{id}). billableMinutes/totalMinutes use actuals where present, else assignments.

By-day plan-vs-actual hours for a person (GET /reports/hours/people/{id}).

Aggregated plan/actual minutes for a project (GET /reports/totals/projects/{id}). Returns a single totals object (no pagination).

Create a phase on a project (POST /projects/{id}/phases). name, startDate, endDate required; color must be one of Runn's allowed hex values (defaults to #67D0D5).

Update a phase (PATCH /projects/{id}/phases/{phaseId}). Only provided fields are changed.

Delete a phase (DELETE /projects/{id}/phases/{phaseId}). Intended for removing a phase AFTER its actuals/assignments have been migrated elsewhere. May fail if the phase still has attached data — migrate first.

Create a milestone on a project (POST /projects/{id}/milestones). title, icon, date required. icon may be a preset (start|end|flag|dollar|warning) or an emoji.

Update a milestone (PATCH /projects/{id}/milestones/{milestoneId}). Only provided fields change.

Create an assignment (POST /assignments). Required: personId, projectId, roleId, startDate, endDate, minutesPerDay. Note: the response may contain multiple segments if the period overlaps leave.

Delete an assignment by ID (DELETE /assignments/{id}). This is a hard delete.

Create a project (POST /projects). Standard mode requires name + clientId. Alternatively pass fromTemplate { templateId, startDate } to duplicate a template.

Update a project (PATCH /projects/{id}). Only provided fields change.

Create a placeholder (POST /placeholders) for allocating external/contractor work. Only roleId is required; the placeholder is auto-named after the role (e.g. 'Content creator Placeholder NN'). To give it a real name, follow up with runn_update_person on the returned id. NOTE: a placeholder with no project/assignment is deleted by Runn within 24 hours.

Update a person or placeholder (PATCH /people/{id}). Use to rename a freshly created placeholder (firstName/lastName), change email/team, or archive. Only provided fields change.

Create a workstream (POST /workstreams). Workstreams are account-level bands of work; create one, then attach it to a project with runn_add_project_workstream. To allocate work to it, pass its id as workstreamId on runn_create_assignment / runn_bulk_actuals. Assignments on the SAME person/role but DIFFERENT workstreams may overlap (Runn sums the load).

Rename a workstream (PATCH /workstreams/{workstreamId}).

Delete a workstream account-wide (DELETE /workstreams/{workstreamId}). Hard delete.

Attach an existing workstream to a project (POST /projects/{projectId}/project-workstreams/{workstreamId}/). No body. Do this once per workstream/project before allocating assignments or actuals on that workstream.

Detach a workstream from a project (DELETE /projects/{projectId}/project-workstreams/{workstreamId}). Removes the project link only; the workstream itself is not deleted.

Create or update up to 100 actuals in one call (POST /actuals/bulk). Each entry overwrites any existing actual for the same project/person/role/date. Either billableMinutes or nonbillableMinutes must be > 0. If any entry is invalid, none are written.