Docs

How Atlas MCP works.

Connect once. Then just tell your AI what to do.

Tools reference

Your AI calls these behind the scenes.

Templates

Use templates when you send the same contract shape repeatedly. The schema (PDF, field positions, variables, party roles) is locked at creation. Only the variable values change per send. Sends with template_id skip the AI detection pipeline. Sub-200ms typical.

Templates default to status: draft. Activate before sending live. Each version snapshot is immutable. Editing a template creates a new version and demotes status back to draft.

Creating a template

Source must be one of from_envelope_id, from_pdf_path, or from_template_id.

curl -X POST https://atlaswork.ai/api/templates \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Standard Lease",
    "source": { "from_envelope_id": "env_abc123" },
    "variables_schema": [
      { "key": "tenant_name",  "label": "Tenant Name",  "type": "string",   "required": true },
      { "key": "monthly_rent", "label": "Monthly Rent", "type": "currency", "required": true },
      { "key": "start_date",   "label": "Start Date",   "type": "date",     "required": true }
    ],
    "parties_schema": [
      { "role_type": "tenant",   "role_label": "Tenant",   "required": true },
      { "role_type": "landlord", "role_label": "Landlord", "required": true }
    ]
  }'

→ { "success": true, "template_id": "tmpl_...", "status": "draft", "version": 1 }

Activating a template

Activation runs structural validation. If the report fails, fix the listed issues and try again. To override a failing report, pass { force: true, force_reason: "..." }.

curl -X POST https://atlaswork.ai/api/templates/tmpl_abc123/activate \
  -H "Authorization: Bearer $API_KEY"

→ { "success": true, "status": "active", "validation_report": { "passed": true, "issues": [] } }

Sending with a template

Pass template_id, variables, and parties to the standard envelope endpoint. No detection runs. Idempotency hash does not include template_version, so retries are safe across version bumps.

curl -X POST https://atlaswork.ai/api/envelope \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tmpl_abc123",
    "variables": { "tenant_name": "John Smith", "monthly_rent": 2400, "start_date": "2026-06-01" },
    "parties": [
      { "role_type": "tenant",   "email": "tenant@example.com",   "name": "John Smith" },
      { "role_type": "landlord", "email": "landlord@example.com", "name": "Acme Properties" }
    ],
    "auto_send": false,
    "idempotency_key": "lease-2026-q2-7741"
  }'

→ {
  "success": true,
  "envelope_id": "env_...",
  "review_url": "https://atlaswork.ai/review/env_...",
  "template_id": "tmpl_abc123",
  "template_version": 1,
  "status": "draft"
}

TypeScript:

const res = await fetch('https://atlaswork.ai/api/envelope', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ATLAS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    template_id: 'tmpl_abc123',
    variables: { tenant_name: 'John Smith', monthly_rent: 2400 },
    parties: [
      { role_type: 'tenant',   email: 'tenant@example.com',   name: 'John Smith' },
      { role_type: 'landlord', email: 'landlord@example.com', name: 'Acme Properties' },
    ],
    idempotency_key: 'lease-2026-q2-7741',
  }),
});
const result = await res.json();

Handling missing info

When required variables or parties are missing, the API returns HTTP 200 with a structured needs_info body. No envelope row is created. No credit is consumed. Surface the missing fields to the user, collect their answers, and retry.

{
  "status": "needs_info",
  "template_id": "tmpl_abc123",
  "template_version": 1,
  "missing_required_variables": [
    { "key": "monthly_rent", "label": "Monthly Rent", "type": "currency", "required": true }
  ],
  "missing_optional_variables": [],
  "missing_parties": [
    { "role_type": "landlord", "role_label": "Landlord", "needs_fields": ["email"] }
  ],
  "validation_errors": [],
  "next_action": "Fill the listed required variables and parties, then POST /api/envelope again."
}

With auto_send: true, any missing required variable returns HTTP 400 instead. auto_send never silently falls back to a draft.

MCP tools

Seven new MCP tools cover the full template lifecycle. See the SDK page for end-to-end agent flows.

Key parameters for send_contract

Your AI knows these automatically. Listed for reference.