Create Agreement

tools/call create_agreement

Creates an agreement owned by the authenticated actor.

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_agreement",
    "arguments": {
      "name": ""
    }
  }
}'

Request

Request Body

{
  "name": "",
  "description": "",
  "intent": "binding",
  "priority": "low",
  "requires_2fa": 0,
  "requires_rcp": 0
}

name

Agreement name.

stringrequired

description

Optional agreement description.

stringoptional

intent

Agreement intent.

binding | nonbindingoptional

priority

Agreement priority.

low | medium | high | urgentoptional

requires_2fa

Whether signing requires verification.

0 | 1optional

requires_rcp

Whether signing requires reciprocal confirmation.

0 | 1optional

Responses

200 OK

{
  "agreement": {
    "description": "",
    "executed_at": "",
    "intent": "",
    "name": "",
    "priority": "",
    "rejected_at": "",
    "rejected_reason": "",
    "ref": "00000000-0000-4000-8000-000000000000",
    "requires_2fa": true,
    "requires_rcp": true,
    "sections": [],
    "status": "",
    "terms": []
  }
}

agreement

Canonical agreement resource.

objectrequired

agreement.description

stringrequired

agreement.executed_at

string (date-time)required

agreement.intent

stringrequired

agreement.name

stringrequired

agreement.priority

stringrequired

agreement.rejected_at

string (date-time)required

agreement.rejected_reason

stringrequired

agreement.ref

Public stable resource reference.

string (uuid)required

agreement.requires_2fa

booleanrequired

agreement.requires_rcp

booleanrequired

agreement.sections

object[]required

agreement.sections[].description

stringrequired

agreement.sections[].name

stringrequired

agreement.sections[].position

integerrequired

agreement.sections[].ref

Public stable resource reference.

string (uuid)required

agreement.sections[].terms

object[]required

agreement.sections[].terms[].description

stringrequired

agreement.sections[].terms[].has_review_history

booleanrequired

agreement.sections[].terms[].locked

booleanrequired

agreement.sections[].terms[].name

stringrequired

agreement.sections[].terms[].negotiable

booleanrequired

agreement.sections[].terms[].pending_counter_proposal

booleanrequired

agreement.sections[].terms[].position

integerrequired

agreement.sections[].terms[].priority

stringrequired

agreement.sections[].terms[].ref

Public stable resource reference.

string (uuid)required

agreement.status

stringrequired

agreement.terms

object[]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