DocsCoding agents
MCP tool reference
Every tool Entalpa's MCP server gives a connected agent, by area: what each one does, whether it reads, writes or can delete, and which use AI.
About this list
These are the 89 tools a connected agent gets: 34 that only read, 46 that can write and 9 that can delete. 20 of them can use AI, and 13 of those only propose. One more serves the review view inside an app, which keeps it from the agent. The list is generated from the server itself, and checked against it whenever either changes.
- Reads: changes nothing.
- Writes: not marked read-only, so it can create or change things.
- Can delete: marked destructive, so the agent's app can ask you first.
- AI: calls a model, or can when asked to, and then spends credits.
- Proposes: an AI tool that drafts changes and applies none of them itself.
Each line is the first sentence of the tool's description. The agent gets the whole description, and the tool's inputs, from the server. What an agent can do says what the labels mean for your projects.
Projects
| Tool | What it does | Kind |
|---|---|---|
projects_list | List projects for the current user. | Reads |
projects_get | Get a project by id. | Reads |
projects_overview | Where a project stands, in one read: counts of stakeholders, stories, requirements (per category and lifecycle status), subsystems and open questions; the gaps that need attention, each with a few ids to start from; the one suggested next step; and the credits AI work on it has used. | Reads |
projects_get_messages | Get message history for a project. | Reads |
projects_create | Create a new project. | Writes |
projects_update | Update a project. | Writes |
projects_patch | Patch a project. | Writes |
projects_delete | Delete a project. | Can delete |
Finding things
| Tool | What it does | Kind |
|---|---|---|
project_search | Case-insensitive substring search across a project's stories, requirements, stakeholders, subsystems, and interface contracts. | Reads |
resolve_ids | Bulk-map references (human ids like Req-012, S-002 or Q-004, UUIDs, or stakeholder names) to entities in one call. | Reads |
The description and the design
| Tool | What it does | Kind |
|---|---|---|
projects_check_description | Check whether description text is sufficiently detailed before creating a project. | Writes, AI |
projects_make_description | Draft a project description for the supplied stakeholder. | Proposes, AI |
projects_specify_design | Draft design specifications linked to system requirements. | Proposes, AI |
Stakeholders
| Tool | What it does | Kind |
|---|---|---|
stakeholders_list | List stakeholders for a project. | Reads |
stakeholders_get | Get a stakeholder by UUID. | Reads |
stakeholders_create | Create a stakeholder. | Writes |
stakeholders_update | Update a stakeholder by UUID. | Writes |
stakeholders_delete | Delete a stakeholder by UUID. | Can delete |
projects_align_stakeholders_to_stories | Propose stakeholder-story links. | Proposes, AI |
projects_align_to_story | Propose stakeholders for an existing story identified by UUID, including a new stakeholder if needed. | Proposes, AI |
Stories
| Tool | What it does | Kind |
|---|---|---|
stories_list | List stories for a project. | Reads |
stories_get | Get a story by UUID. | Reads |
stories_get_many | Fetch multiple stories by UUID in one call. | Reads |
stories_create | Create a story. | Writes, AI |
stories_update | Update a story. | Writes, AI |
stories_delete | Delete a story by UUID. | Can delete |
projects_make_stories_from_description | Draft stakeholders and their stories from the project description. | Proposes, AI |
projects_ask_extra_feature | Suggest missing features and clarifying stakeholder questions; optionally supply previously rejected suggestions. | Proposes, AI |
projects_audit_backlog | Audit the story backlog and propose story creations, updates, or deletions. | Proposes, AI |
Open questions
| Tool | What it does | Kind |
|---|---|---|
open_questions_list | List the project's open elicitation questions. | Reads |
open_questions_answer | Answer or dismiss an open question. | Writes |
open_questions_convert_to_story | Write an answered open question's decision into the backlog. | Writes, AI |
Requirements
| Tool | What it does | Kind |
|---|---|---|
requirements_list | Retrieve requirements for analysis, coding or automation without displaying UI. | Reads |
requirement_items_list | Retrieve normal requirements and generated interface requirement rows for analysis, coding or automation without displaying UI. | Reads |
requirements_get | Get a requirement by UUID. | Reads |
requirements_get_many | Fetch multiple requirements by UUID in one call. | Reads |
requirements_show | Show requirements and generated interfaces in an interactive view where the user can browse them and select items to discuss. | Reads |
requirements_create | Create a requirement. | Writes |
requirements_update | Update a requirement. | Writes |
requirements_patch | Patch a requirement. | Writes |
requirements_confirm_sources | Confirm a suspect requirement still holds for its stories as they read now, without rewriting it: clears suspect_story_ids. | Writes |
requirements_delete | Delete a requirement by UUID. | Can delete |
projects_generate | Generate requirement suggestions and revisions, preserving locked requirements. | Proposes, AI |
projects_analyze | Analyze selected requirements by UUID and propose revisions or removals. | Proposes, AI |
projects_propagate_stories | Propagate selected stories by UUID into system requirements and optional subsystem requirements, with traceability links. | Proposes, AI |
projects_align_requirements_to_stories | Propose story-requirement links. | Proposes, AI |
Subsystems and interface contracts
| Tool | What it does | Kind |
|---|---|---|
subsystems_list | List subsystems for a project. | Reads |
subsystems_get | Get a subsystem by id. | Reads |
subsystems_create | Create a subsystem. | Writes |
subsystems_update | Update a subsystem. | Writes |
subsystems_delete | Delete a subsystem by UUID. | Can delete |
interface_contracts_list | List interface contracts for a project. | Reads |
interface_contracts_get | Get an interface contract by id. | Reads |
interface_contracts_create | Create an interface contract between two subsystems. | Writes |
interface_contracts_update | Update an interface contract. | Writes |
interface_contracts_patch | Patch an interface contract. | Writes |
interface_contracts_delete | Delete an interface contract by UUID. | Can delete |
projects_detect_subsystems | Propose subsystem additions, changes, deletions, requirement assignments, and optional interface contracts. | Proposes, AI |
projects_propagate_requirements_to_subsystems | Propagate selected system requirements by UUID into requirements for existing subsystems, with parent links. | Proposes, AI |
Suggestions to review
| Tool | What it does | Kind |
|---|---|---|
suggestions_list | List AI suggestions waiting for review, grouped by the run that made them (Analyze, Generate, Audit backlog, Propagate stories), newest first. | Reads |
suggestions_review | Show one run's saved suggestions in an interactive review where the user accepts or declines each proposed change, shown beside what it would change. | Reads |
suggestions_review_get | Read one batch of suggestions as the review view shows it: each item beside its target as it is now, and what accepting it now would do. | App view only |
suggestions_accept | Apply suggestions, by the ids a run's saved_suggestions or suggestions_list gives, all as one change a single undo reverts. | Can delete |
suggestions_reject | Decline suggestions, by the ids a run's saved_suggestions or suggestions_list gives. | Writes |
The Spec score
| Tool | What it does | Kind |
|---|---|---|
projects_spec_score | The Spec score: how ready a project's spec is to hand to a coding agent. | Reads |
projects_get_assessment | The project's Spec score as last stored, by an assessment (projects_assess) or a change of projects_spec_score_settings: 0 to 100, and the score in words. | Reads |
projects_assess | Assess the spec and give its Spec score (0-100, with a band: Draft, Developing, Reviewable, Ready to build). | Writes, AI |
projects_spec_score_settings | Set how a project's Spec score weighs its areas and quality attributes. | Writes |
Packs
| Tool | What it does | Kind |
|---|---|---|
packs_list | List the packs the user can check a project with: Entalpa's published packs (by_entalpa), then the user's own and those shared with them. | Reads |
packs_get | Get a pack and every concern with its owners: one of the user's, one shared with them, or Entalpa's (read as published). | Reads |
projects_review_with_pack | Check a project with a pack: an expert's checklist (privacy, security, accessibility, payments, or the user's own) whose concerns are read against this project's stories, requirements and questions. | Writes, AI |
packs_create | Create a pack: an expert's checklist that other projects are checked with (projects_review_with_pack). | Writes |
packs_update | Change a pack the user can edit; read it with packs_get first. | Can delete |
packs_delete | Delete a pack the user owns. | Can delete |
Versions and undo
| Tool | What it does | Kind |
|---|---|---|
projects_list_snapshots | List saved snapshots for a project (most recent first). | Reads |
get_project_snapshot | Get a saved snapshot's full detail, including the project state captured at snapshot time. | Reads |
projects_diff | Diff a project between a base snapshot and a compare state (another snapshot id, or 'current' — the default). | Reads |
create_project_snapshot | Save a snapshot of the project's current state. | Writes |
restore_project_snapshot | Restore a project to a previously saved snapshot's state, overwriting its current stories, requirements, and related content. | Writes |
projects_undo | Undo the last project change. | Writes |
projects_redo | Redo last undone project change. | Writes |
Import and export
| Tool | What it does | Kind |
|---|---|---|
projects_export | Export a project to the portable format projects_import reads. | Reads |
projects_export_openspec | Write the project out as OpenSpec files: one openspec/specs/<domain>/spec.md per subsystem plus one for system-level requirements. | Reads |
projects_export_speckit | Write the project out as one GitHub Spec Kit feature, specs/<NNN>-current-system/spec.md, holding the whole current system in the spec template's shape. | Reads |
projects_import | Import a project from the portable format projects_export writes. | Writes |
projects_import_openspec | Create a project from a public GitHub repository that uses OpenSpec. | Writes |
projects_import_speckit | Create a project from a public GitHub repository that uses GitHub Spec Kit (specs/<feature>/spec.md). | Writes |
projects_update_speckit_import | For a project created by projects_import_speckit: read the same repository again and import the features added since, as written. | Writes |
projects_fold_speckit_features | After projects_import_speckit: fold the imported Spec Kit features into one backlog, oldest first. | Writes, AI |
Your account
| Tool | What it does | Kind |
|---|---|---|
users_get_me | Get current user profile. | Reads |