MCP Tool

artifact_write

Create, update, or delete a file artifact. `create` requires `name` and `content` (markdown by default, or html); `update`/`delete` require `id`.

Input schema

api_keystring
Optional API key for authentication.
action"create" | "update" | "delete"required
The operation to perform.
idstring
Artifact ID (required for update/delete).
namestring
Name/label (required for create).
contentstring
Artifact content (required for create).
format"markdown" | "html"
Content format (markdown is the default).
external_idstring | null
Your own identifier for the resource (up to 200 chars, not required to be unique; filterable via the read tool), or null to clear.

Example call

tools/call params
{
  "name": "artifact_write",
  "arguments": {
    "api_key": "agt_…",
    "action": "create"
  }
}