Create Section Comment

tools/call create_section_comment

Creates a comment on a section.

Conventions

Authentication

All endpoints require a Bearer token. Pass it in the Authorization header as Bearer <token>. Tokens are issued from the API settings page in your workspace.

Base URL

All paths are relative to https://mcp.allsign.app. The spec includes full paths; strip the base when constructing requests.

Versioning

The current version is 0.1.0. Breaking changes are documented in the Changelog and announced before taking effect.

Specification

The server follows the MCP specification and communicates via JSON-RPC 2.0. All documentation on this page is generated directly from the spec.

Example

Bash

curl "https://mcp.allsign.app" \
  -X POST \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_section_comment",
    "arguments": {
      "section_ref": "00000000-0000-4000-8000-000000000000",
      "content": ""
    }
  }
}'

Request

Request Body

{
  "section_ref": "00000000-0000-4000-8000-000000000000",
  "content": ""
}

section_ref

Public stable resource reference.

string (uuid)required

content

Comment content.

stringrequired

Responses

200 OK

{
  "comment": {
    "actor": {
      "avatar_url": "",
      "name": "",
      "ref": "00000000-0000-4000-8000-000000000000"
    },
    "content": "",
    "created_at": "",
    "on_revision": true,
    "ref": "00000000-0000-4000-8000-000000000000",
    "revision": "",
    "section": "",
    "term": ""
  }
}

comment

Canonical comment resource.

objectrequired

comment.actor

Actor identity attached to a comment.

objectrequired

comment.actor.avatar_url

stringrequired

comment.actor.name

stringrequired

comment.actor.ref

string (uuid)required

comment.content

stringrequired

comment.created_at

string (date-time)required

comment.on_revision

booleanrequired

comment.ref

Public stable resource reference.

string (uuid)required

comment.revision

objectrequired

comment.section

objectrequired

comment.term

objectrequired

Errors

Standard JSON-RPC 2.0 error codes apply.

-32600

Invalid Request

erroroptional

-32601

Method not found

erroroptional

-32602

Invalid params

erroroptional

-32603

Internal error

erroroptional

401

Bearer token missing or invalid

erroroptional

403

Actor does not have the required capacity for this operation

erroroptional