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 to wait for completion.

#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, steer, retry, pin, or unpin governed Atoi threads through the authenticated operator surface. A running reply is steered, never stopped.

#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 results 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 results.

#Arguments for atoi_automations

#Result from atoi_automations

Returns Automation records, receipts of what they ran, or mutation results 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_ideas

Read, refresh, answer, or dismiss the Ideas the agent writes for the signed-in person.

#Arguments for atoi_ideas

#Result from atoi_ideas

Returns the Ideas as JSON text content: the sections and their tiles, when they were written, and the current ask with its options; refresh returns a scheduled status.

#Call and response for atoi_ideas

{
  "tool": "atoi_ideas",
  "arguments": { "action": "list" }
}

{
  "status": "confirmed",
  "ideas": {
    "written": { "writtenAt": 1788990000000 },
    "generatedAt": 1788990000000,
    "nothingMaterial": false,
    "current": null,
    "sections": [
      {
        "title": "Teach it your style",
        "tiles": [{ "title": "Connect your computer" }]
      }
    ]
  }
}

#atoi_plan

List the plans in one Workspace or Project with their ids, titles, status and progress, or retire or restore one of the person's plans.

#Arguments for atoi_plan

#Result from atoi_plan

Returns the plans in the scope read with their ids, status and progress, or the retired or restored plan with its receipt, as JSON text content.

#Call and response for atoi_plan

{
  "tool": "atoi_plan",
  "arguments": {
    "action": "archive",
    "plan_id": "pln_3k8d",
    "workspace_id": "wsp_7m4c"
  }
}

{
  "plan": {
    "planId": "pln_3k8d",
    "title": "Friday launch",
    "status": "archived"
  },
  "receipt": {
    "planId": "pln_3k8d",
    "status": "archived"
  }
}

#atoi_usage

Read what this person's turns cost: today, the last days, and the models that spent it.

#Arguments for atoi_usage

#Result from atoi_usage

Returns the usage summary for the scope read: today, the window, a row per day, and a row per model, as JSON text content.

#Call and response for atoi_usage

Costs are in microdollars: 420000 is $0.42, and range gives the window endpoints as Unix milliseconds

{
  "tool": "atoi_usage",
  "arguments": {
    "action": "get",
    "days": 7,
    "workspace_id": "wsp_7m4c"
  }
}

{
  "resource": "usage",
  "action": "get",
  "status": "confirmed",
  "scope": {
    "mode": "workspace",
    "workspaceId": "wsp_7m4c",
    "name": "Launch"
  },
  "range": {
    "days": 7,
    "from": 1788955200000,
    "to": 1789560000000
  },
  "usage": {
    "range": {
      "days": 7,
      "from": 1788955200000,
      "to": 1789560000000
    },
    "today": {
      "turns": 1,
      "inputTokens": 1000,
      "outputTokens": 400,
      "costMicrodollars": 420000,
      "unpricedTurns": 0
    },
    "window": {
      "turns": 2,
      "inputTokens": 4000,
      "outputTokens": 1000,
      "costMicrodollars": 3100000,
      "unpricedTurns": 0
    },
    "days": [
      {
        "day": "2026-09-16",
        "turns": 1,
        "inputTokens": 1000,
        "outputTokens": 400,
        "costMicrodollars": 420000,
        "unpricedTurns": 0
      },
      {
        "day": "2026-09-15",
        "turns": 1,
        "inputTokens": 3000,
        "outputTokens": 600,
        "costMicrodollars": 2680000,
        "unpricedTurns": 0
      }
    ],
    "models": [
      {
        "model": "deepseek-v4-pro",
        "provider": "deepseek",
        "turns": 2,
        "inputTokens": 4000,
        "outputTokens": 1000,
        "costMicrodollars": 3100000,
        "unpricedTurns": 0
      }
    ],
    "truncated": false
  }
}

#atoi_channels

List and inspect your messaging links (Telegram, Slack, push), open browser-native connection flows, revoke links, or send a receipt-backed test.

#Arguments for atoi_channels

#Result from atoi_channels

Returns link state, authorization data, delivery receipts, or revocation results 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 results 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"
    }
  ]
}

Read MCP and plugins to configure a client, or Troubleshooting when a call comes back empty.