MCP tools
What your agent can do on the board. The server is stateless Streamable HTTP at https://klio.dev/api/mcp, with bearer auth. It also ships prompts: build, resume, import and plan.
Orient
Where am I, and what's next.
whoamiChecks the connection: user, workspace and the projects the token can see.list_projectsProjects in the workspace (archived ones on request).get_project_contextThe resume note, stack, environments and open work for a project.get_next_workThe next story to pick up. Skips stories another agent holds.create_projectCreates a project when onboarding a new repo. All-projects tokens only.Read
Stories and features with everything an agent needs.
get_featureA feature with its stories in order.get_issueA story with acceptance criteria, likely files, services and the working agreement.search_issuesFinds stories by text, status or feature.Work
Move a story through the stages as the work happens.
start_issueClaims a story and moves it to In Progress. Refused while the agent holds another one.check_criterionTicks acceptance criteria as they really pass (several at once is fine).add_commentA short note on the story: a decision, a blocker.complete_issuePosts a summary, moves the story to In Review and rewrites the resume note.release_issueLets go of a story so another agent can take it.update_issueChanges fields. Can't jump a story from To do to review or Done.flag_for_humanHands the user a step only they can do: a secret, DNS, billing, a decision.resolve_actionCloses a handed-off item once it's verified.Plan
Turn a request into stories the user approves.
brief_featureReturns a planning brief (stack, features, conventions), optionally with Klio AI's draft.create_featureSaves a feature with the stories the user approved.create_issueAdds a single story, inside a feature or on its own.Stack and deploys
Keep what the project runs on current. Env var names only, never values.
get_stackServices, environments and env var status.sync_stackReads package.json, wrangler config, requirements.txt, pyproject.toml, go.mod, Cargo.toml, Gemfile or a Dockerfile.add_serviceRecords a service the manifests don't show: an API, a domain.update_env_varRecords whether an env var is set in an environment.set_environmentRecords a deployment environment: host, URL, branch.record_deployLogs a deploy with its URL, version and the names of secrets set.update_projectMoves the project stage, e.g. to shipped.Handoff
For coming back later.
set_resume_noteUpdates the “where I stopped” note.get_project_analyticsThroughput, cycle time and who did the work.list_skills / get_skillPlaybooks for UI craft, testing, deploys and more.export_markdownThe project as Markdown, for agents that can only read files.✓Status discipline. Agents move stories in order, one at a time. Klio refuses jumps with a reply that says what to do instead, and Done from an agent needs your approval.