MCP tools reference

Use this reference after you connect a coding client through MCP and plugins. Each call acts on the same Atoi records as the apps and returns a governed result envelope.

#atoi_projects

List, get, create, update, archive, or restore governed Atoi Projects.

#Arguments for atoi_projects

#Result from atoi_projects

Returns a Project list or a Project, source, and receipt projection as JSON text content.

#Call and response for atoi_projects

{
  "tool": "atoi_projects",
  "arguments": {
    "action": "get",
    "project_id": "prj_8k2v"
  }
}

{
  "project": {
    "id": "prj_8k2v",
    "name": "Atlas notes"
  },
  "source": {
    "binding": null
  }
}

#atoi_workspace

Show or bind the stable source associated with an Atoi Project.

#Arguments for atoi_workspace

#Result from atoi_workspace

Returns Project source binding, source state, change sets, and mutation receipts as JSON text content.

#Call and response for atoi_workspace

{
  "tool": "atoi_workspace",
  "arguments": {
    "action": "show",
    "project_id": "prj_8k2v"
  }
}

{
  "project": {
    "id": "prj_8k2v",
    "name": "Atlas notes"
  },
  "source": {
    "projectId": "prj_8k2v",
    "binding": null
  }
}

#atoi_tasks

List, get, start, cancel, continue, inspect, apply, or publish authoritative Atoi Task change sets. Poll get for wait semantics.

#Arguments for atoi_tasks

#Result from atoi_tasks

Returns Task state, change sets, placement requests, or action receipts as JSON text content.

#Call and response for atoi_tasks

{
  "tool": "atoi_tasks",
  "arguments": {
    "action": "start",
    "project_id": "prj_8k2v",
    "prompt": "Audit the release state and return evidence.",
    "safety_profile": "safe"
  }
}

{
  "task": {
    "id": "tsk_3m9q",
    "status": "queued"
  }
}

#atoi_threads

List, inspect, send to, retry, stop, pin, or unpin governed Atoi chat Threads through the authenticated operator surface.

#Arguments for atoi_threads

#Result from atoi_threads

Returns Thread state, messages, and send or mutation receipts as JSON text content.

#Call and response for atoi_threads

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "send",
    "thread_id": "thr_9c4k",
    "prompt": "Summarize the release blockers.",
    "delivery_id": "msg_release_1"
  }
}

{
  "thread": {
    "id": "thr_9c4k"
  },
  "receipt": {
    "status": "completed",
    "messageId": "msg_2v7b"
  }
}

#atoi_search

Search accessible Atoi threads, messages, projects, Tasks, files, and outputs.

#Arguments for atoi_search

#Result from atoi_search

Returns the matched accessible records as JSON text content.

#Call and response for atoi_search

{
  "tool": "atoi_search",
  "arguments": {
    "query": "release evidence",
    "limit": 10
  }
}

{
  "query": "release evidence",
  "results": []
}

#atoi_inbox

List and resolve durable Atoi Inbox decisions with exact item and approval identity.

#Arguments for atoi_inbox

#Result from atoi_inbox

Returns Inbox items or decision readback as JSON text content.

#Call and response for atoi_inbox

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "list",
    "status": "unread",
    "limit": 10
  }
}

{
  "items": [
    {
      "id": "inb_4d6p",
      "status": "unread",
      "title": "Publish release notes"
    }
  ]
}

#atoi_automations

List, inspect, create, update, toggle, trigger, or remove Atoi Automations with schedule and receipt readback.

#Arguments for atoi_automations

#Result from atoi_automations

Returns Automation records, run receipts, or mutation readback as JSON text content.

#Call and response for atoi_automations

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "trigger",
    "automation_id": "aut_5k1m",
    "input_message": "Check the candidate tag."
  }
}

{
  "receipt": {
    "automationId": "aut_5k1m",
    "runId": "run_4q7c"
  }
}

#atoi_channels

List and inspect user-owned Atoi Channels, open browser-native connection flows, revoke links, or send a receipt-backed test.

#Arguments for atoi_channels

#Result from atoi_channels

Returns Channel state, authorization data, delivery receipts, or revocation readback as JSON text content.

#Call and response for atoi_channels

{
  "tool": "atoi_channels",
  "arguments": {
    "action": "test",
    "link_id": "lnk_8s3d",
    "idempotency_key": "test_release_1"
  }
}

{
  "status": "sent",
  "receipt": {
    "linkId": "lnk_8s3d",
    "deliveryStatus": "sent"
  }
}

#atoi_skills

List, inspect, enable, disable, or remove user-owned Atoi Skills with durable skill receipts.

#Arguments for atoi_skills

#Result from atoi_skills

Returns Skill state and durable Skill receipts as JSON text content.

#Call and response for atoi_skills

{
  "tool": "atoi_skills",
  "arguments": {
    "action": "get",
    "skill_id": "skl_6h2n"
  }
}

{
  "skill": {
    "skillId": "skl_6h2n",
    "name": "Release review",
    "enabled": true
  }
}

#atoi_plugins

List, inspect, install, enable, disable, or remove the pinned first-party Atoi plugin release with durable plugin receipts.

#Arguments for atoi_plugins

#Result from atoi_plugins

Returns plugin state and durable plugin receipts as JSON text content.

#Call and response for atoi_plugins

{
  "tool": "atoi_plugins",
  "arguments": {
    "action": "get",
    "plugin_id": "atoi"
  }
}

{
  "plugin": {
    "pluginId": "atoi",
    "enabled": true
  }
}

#atoi_settings

Read canonical account settings and connector state, or connect and disconnect browser-owned Atoi connections.

#Arguments for atoi_settings

#Result from atoi_settings

Returns account setting and connector state, authorization data, or disconnect readback as JSON text content.

#Call and response for atoi_settings

{
  "tool": "atoi_settings",
  "arguments": {
    "action": "get"
  }
}

{
  "connections": [
    {
      "id": "github",
      "status": "connected"
    }
  ]
}

#atoi_doctor

Return the canonical Atoi runtime readiness ledger and compact receipt without promoting unobserved checks to ready.

#Arguments for atoi_doctor

#Result from atoi_doctor

Returns the canonical runtime readiness ledger and compact readiness receipt as JSON text content.

#Call and response for atoi_doctor

{
  "tool": "atoi_doctor",
  "arguments": {
    "action": "status"
  }
}

{
  "status": "ok",
  "checks": [
    {
      "id": "node",
      "status": "ok"
    }
  ]
}