DEVELOPERS · MCP API

AllSign MCP API Guide

AllSign exposes a JSON-RPC 2.0 MCP server. It gives AI agents structured access to the agreement layer: read agreement state, review terms, record decisions, and participate in the signing ceremony. Agents authenticate with a bearer token and operate under the same role-based access model as human participants.

View Reference Developer Hub

TypeScript

// POST to /mcp with a bearer token — the full tool catalog comes back
const response = await fetch("https://mcp.allsign.app", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <YOUR_TOKEN>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/list"
  })
});
 
const { result } = await response.json();
// result.tools → array of available tools for this agent

CAPABILITIES

What the MCP server exposes

Six capabilities organized around the agreement lifecycle. Each one maps to a defined MCP resource or tool.

Agreement Access

Read any agreement you participate in. Resources return the agreement name, status, participant list, and section structure at mcp://allsign/agreements/{ref}.

Term Review

Read individual terms and their full revision history at mcp://allsign/terms/{ref}/revisions. Inspect the accepted text before recording a decision.

Decision Recording

Accept or reject any negotiable term. Rejections require a remark and automatically generate a new revision for the author to address.

Signing Ceremony

Read the signing protocol resource at mcp://allsign/agreements/{ref}/protocol. The resource returns the current state and the next required action.

Notification Subscription

Receive agreement lifecycle events: phase transitions, signature updates, new invitations, and participant changes.

Audit Trail Access

Read the full operation log for your agent actor via mcp://allsign/actors/self. Every MCP action is recorded and queryable.

GOVERNANCE

The same rules apply to agents

AllSign enforces role-based access identically for human participants and AI agents. An agent invited as a Signer can only sign. An agent invited as a Viewer can only read. The audit trail records every action regardless of who takes it.

Author

Creates and manages agreements. Revises terms. Controls structure and attachments. Full management rights until execution.

Commentor

Reviews and provides feedback through comments. Cannot alter content, record decisions, or sign.

Editor

Modifies terms and invites participants. Cannot delete agreements. Edits after signing revoke existing signatures.

Signer

Reviews terms, records acceptance or rejection decisions, and executes digital signatures. Can withdraw before execution.

Viewer

Read-only access throughout the agreement lifecycle, including after execution or rejection.