Actions Reference

Every tool exposed by the Allye MCP server and the actions each one accepts.

Each tool takes an action field that selects the operation, plus the fields that action needs. Tool and action names below are the ones the server exposes. Authorization is always enforced by the Allye API, so a call can be refused even when the action exists.

Projects, epics, specs and tasks follow the hierarchy Project > Epic > Spec > Task and use keys such as KEY-N (spec) and KEY-N.M (task). Call initialize at the start of a session, and pass team_id when you belong to more than one team and the default team is not the right one.

initialize

Bootstraps the session: loads your user, tenant, teams and core documents.

Action	Purpose
`init`	Load user context, teams and core documents for the session.

allye_health_check

Takes no action field.

Action	Purpose
(none)	Check that the Allye backend is reachable and healthy.

team

Action	Purpose
`team_help`	Show the team actions and how to use them.
`team_list`	List the teams you belong to.
`team_current`	Show the default team in use.
`team_members`	List the members of a team.
`team_set_default`	Set your default team by name, prefix or ID. Applies to all your sessions in the tenant.
`team_switch`	Deprecated alias of `team_set_default`.

projects

Action	Purpose
`project_list`	List projects of your teams.
`project_get`	Read one project by key or ID.
`project_overview`	Read a project with its apps and KPIs.
`project_create`	Create a project with a name and a short key.
`project_update`	Edit a project (the key cannot change).
`project_resolve`	Find the project, app and team that match a repository URL.
`app_list`	List the apps (repositories) of a project.
`app_create`	Add an app to a project.
`app_update`	Edit an app.
`app_archive`	Hide an app that is no longer used.
`app_unarchive`	Bring an archived app back.

epics

An epic's status is calculated from its specs; the only manual transitions are cancel and reopen.

Action	Purpose
`epic_list`	List the epics of a project.
`epic_get`	Read an epic with its specs.
`epic_create`	Create an epic (goal, scope, out of scope, success metrics).
`epic_update`	Edit an epic.
`epic_cancel`	Cancel an epic; its specs stay as they are.
`epic_reopen`	Reactivate a cancelled epic.

specs

Lifecycle: draft, in review, approved, in progress, done, plus cancelled.

Action	Purpose
`spec_list`	List specs with filters (project, epic, status, app, tags).
`spec_get`	Read a spec, or a historical version of it.
`spec_context`	Read the spec with its anchors, tasks, apps, dependencies, epic and AC coverage in one call.
`spec_create`	Create a spec in a project.
`spec_validate`	Check a draft (and proposed tasks) without writing anything.
`spec_update`	Edit a spec, move it between epics or detach it.
`spec_submit`	Move a draft to review.
`spec_back_to_draft`	Move a spec in review back to draft.
`spec_approve`	Approve a spec in review. Only when the user explicitly asks.
`spec_remove_approval`	Remove your own approval.
`spec_cancel`	Cancel a spec (its tasks are not cancelled).
`spec_reopen`	Reopen a done or cancelled spec.
`spec_versions`	List the versions of a spec.
`spec_diff`	Compare two versions of a spec.
`spec_anchors`	List the anchors (`BR`, `AC`, `D`, `NFR`, `Q`) of a spec.
`spec_coverage`	Show which acceptance criteria are covered by tasks.
`spec_dependency_add`	Make a spec depend on another spec.
`spec_dependency_remove`	Remove a spec dependency.
`spec_stale`	List specs that have not moved for a number of days.

tasks

Lifecycle: todo, in progress, in review, done, plus cancelled. Every task goes through review before done.

Action	Purpose
`task_list`	List tasks of a project or spec.
`task_mine`	List your tasks.
`task_next`	Pick the next task ready to start.
`task_get`	Read one task.
`task_create`	Create a task in a spec.
`task_bulk_create`	Create several tasks at once with dependencies between them.
`task_update`	Edit a task, its dependencies, branch or PR URL.
`task_start`	Start a task (spec approved, dependencies done).
`task_stop`	Stop a task in progress.
`task_submit`	Send a task to review.
`task_request_changes`	Send a task in review back to in progress.
`task_complete`	Mark a task in review as done.
`task_cancel`	Cancel a task.
`task_reopen`	Reopen a done or cancelled task.

kb

The project knowledge base: company, project and personal spaces of pages.

Action	Purpose
`kb_spaces`	List the spaces you can read.
`kb_tree`	Show the page tree of a space.
`kb_search`	Search pages.
`kb_read`	Read a page, its outline or one section.
`kb_create`	Create a page in a space or under a parent page.
`kb_update`	Replace the content of a page, based on the revision you read.
`kb_section`	Replace, append to or prepend to one section of a page.
`kb_move`	Move a page under another parent or to the space root.
`kb_backlinks`	List the pages that link to a page, or the pages linked to a spec.
`kb_history`	List the versions of a page, or read one version.
`kb_restore`	Restore a previous version of a page as the new current one.

intelligence

Memories with semantic search and a relation graph.

Action	Purpose
`memory_save`	Save a memory; similar existing memories are merged, superseded or skipped instead of duplicated.
`memory_search`	Search memories by meaning, optionally with graph context.
`memory_get`	Read one memory.
`memory_list`	List memories with filters.
`memory_graph`	Explore the graph around a memory.
`memory_relations`	List the direct relations of a memory.
`memory_preferences`	Load your pinned preferences briefing.
`memory_relocation_candidates`	List personal memories that could move to a team. Writes nothing.
`memory_relocation_apply`	Move the memories you approved to a team.
`memory_relocation_dismiss`	Decline the relocation flow.

skills

The Skills library you are authorized to use.

Action	Purpose
`skill_list`	List the skills you can read.
`skill_get`	Read a skill and its current revision.
`skill_create`	Create a personal, team or organization skill.
`skill_update`	Save changes to a skill.
`skill_delete`	Move a skill to the trash.
`skill_list_revisions`	List the earlier revisions of a skill.
`skill_restore_revision`	Copy an earlier revision into a new current revision.

productivity

Personal and team TODOs.

Action	Purpose
`todo_create`	Create a TODO.
`todo_list`	List TODOs (pending and in progress by default).
`todo_get`	Read one TODO.
`todo_update`	Edit a TODO.
`todo_delete`	Delete a TODO.
`todo_stats`	Show aggregated TODO statistics.
`todo_search`	Search TODOs by text.
`todo_overdue`	List overdue TODOs.
`todo_upcoming`	List TODOs due soon.
`todo_categories`	List the categories in use.
`todo_tags`	List the tags in use.
`todo_help`	Show the supported actions.

user_config

Your personal configuration documents.

Action	Purpose
`create`	Create a document.
`list`	List your documents.
`get`	Read one document.
`update`	Edit a document.
`delete`	Remove a document.
`help`	Show the available actions.

api_catalog

Action	Purpose
`api_catalog_search`	Find API specifications by natural language.
`api_catalog_list`	List the API specifications you can see.
`api_catalog_get`	Read one API specification with its endpoints.

Next steps

Installation to connect a harness to the server.
Allye plugin for the skills and agents that call these tools.