Create Term

tools/call create_term

Creates a term within an owned agreement.

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_term",
    "arguments": {
      "agreement_ref": "00000000-0000-4000-8000-000000000000",
      "name": ""
    }
  }
}'

Request

Request Body

{
  "agreement_ref": "00000000-0000-4000-8000-000000000000",
  "name": "",
  "description": "",
  "negotiable": true,
  "position": 1,
  "priority": "low",
  "section_ref": "00000000-0000-4000-8000-000000000000"
}

agreement_ref

Public stable resource reference.

string (uuid)required

name

Term name.

stringrequired

description

Optional term description.

stringoptional

negotiable

Whether the term is negotiable.

booleanoptional

position

Optional term position.

integeroptional

priority

Term priority.

low | medium | high | urgentoptional

section_ref

Public stable resource reference.

string (uuid)optional

Responses

200 OK

{
  "term": {
    "description": "",
    "has_review_history": true,
    "locked": true,
    "name": "",
    "negotiable": true,
    "pending_counter_proposal": true,
    "position": 1,
    "priority": "",
    "ref": "00000000-0000-4000-8000-000000000000"
  }
}

term

Canonical term resource.

objectrequired

term.description

stringrequired

term.has_review_history

booleanrequired

term.locked

booleanrequired

term.name

stringrequired

term.negotiable

booleanrequired

term.pending_counter_proposal

booleanrequired

term.position

integerrequired

term.priority

stringrequired

term.ref

Public stable resource reference.

string (uuid)required

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