Skip to content
AtomPRD

Tools

The MCP server ships 12 tools. Read tools are unrestricted within the project scope; write tools log to audit_log and are rate-limited.

Read (8)

Section titled “Read (8)”

list_atoms

Section titled “list_atoms”
{ "kind": "feature", "module_id": "mod_habits_e5f6", "status": "in_progress" }

Filter by kind / module_id / status. Returns array of atoms.

get_atom

Section titled “get_atom”
{ "id": "feat_create_habit_h14a" }

Fetch one atom by ID. Returns the atom including intent / behavior / provenance.

query_relations

Section titled “query_relations”
{ "from": "feat_create_habit_h14a", "type": "verifies" }

Walk edges. Either from or to (or both) plus optional type. Returns array of edges.

find_criteria

Section titled “find_criteria”
{ "feature_id": "feat_create_habit_h14a" }

Convenience: walks verifies reverse edges from a feature. Returns array of criteria.

get_export

Section titled “get_export”
{ "target": "senlang", "scope": "project" }

Pull the latest export output for a target. target is one of senlang / nestjs / vue (etc., per project config). Returns file map.

read_runtime_block

Section titled “read_runtime_block”
{ "kind": "env_var", "scope_service": "svc_cloud_api_a1b2" }

Read DevOps blocks (service / env_var / vendor / host_domain / build_step / deploy_target).

get_intent

Section titled “get_intent”
{ "atom_id": "feat_create_habit_h14a" }

Layer 1 only. Returns { userStory, relatedAtoms, notes }.

get_behavior

Section titled “get_behavior”
{ "atom_id": "feat_create_habit_h14a" }

Layer 2 + provenance. Returns { behavior, provenance }.

Write (4)

Section titled “Write (4)”

update_criterion_status

Section titled “update_criterion_status”
{ "criterion_id": "cri_initial_load_h31a", "status": "done" }

Status: idea / in_progress / done / blocked. Logs.

mark_task_done

Section titled “mark_task_done”
{ "task_id": "tsk_implement_create_h14a" }

Convenience write — flips task.status to done. Logs.

Section titled “link_code_path”
{ "atom_id": "feat_create_habit_h14a",
  "code_path": "src/features/createHabit.ts:14-87" }

Records a link from an atom to a source file range. Surfaces in the cloud authoring UI’s “Implementation” panel. Logs.

query_graph

Section titled “query_graph”
{ "starting_at": "feat_create_habit_h14a",
  "follow": ["uses_entity", "uses_rule"],
  "max_depth": 2 }

Generic graph traversal. Returns nodes + edges discovered. Logs (read-shaped but expensive enough to log for cost analysis).

Audit log

Section titled “Audit log”

Every write tool appends to audit_log with (actor, tool, args, atom_id, timestamp, ip). Project owners can query the log via the cloud dashboard.

Rate limits

Section titled “Rate limits”
  • Read: 600 req/min/token.
  • Write: 60 req/min/token.

Limits return 429 with Retry-After header. The MCP server back-pressures the agent transparently.

See also

Section titled “See also”