> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atlaswork.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> The Atlas signing tools available to AI agents.

Connect a compatible client to `https://mcp.atlaswork.ai/mcp`. The client lists
the typed schemas and calls tools through MCP; these are not REST endpoints.

## Sending

### `send_contract_for_review`

Creates a review-first envelope. Supply `parties[]` and exactly one intake:

* `document_text` for a contract drafted in chat
* `document_url` for a public PDF or DOCX
* `document_id` to reuse an existing Atlas envelope's source document
* `document_file` for a host-provided attachment
* `request_document_upload: true` for a one-shot upload URL

Optional `document_filename` preserves the source filename and
`document_name` sets the human-facing contract name. The result includes
`envelope_id`, `review_url`, lifecycle/detection status, and the v2 envelope
graph. A human approves the review before signing emails are sent.

### `complete_upload_session`

After the user uploads to a `needs_document.upload_url`, pass its
`upload_session`. Atlas verifies and hashes the bytes, anchors the original
document, and starts field detection. Repeating completion is safe.

### `send_contract_from_template`

Creates an envelope from a saved template's pinned layout. Call
`get_template` first, then supply `template_id` and one party for each
`parties_for_send.role_name`. `auto_send` defaults to `true`; pass `false` for
a review-first draft. `prefill_map` accepts keys advertised by the template.

## Templates

### `list_templates`

Lists reusable templates with readiness, status, subtitle, usage, and cursor
pagination fields.

### `get_template`

Returns `parties_for_send`, `stored_signatures`, `template_roles`,
`optional_prefill_keys`, `signer_field_count`, `do_not_include_in_parties`,
and an `example_create` payload.

## Reading and status

### `get_envelope`

Returns the full v2 envelope graph plus model-friendly snake\_case lifecycle,
party, field, document, and timestamp fields.

### `check_signing_status`

Lightweight polling surface: status, signed count, next signer, terminal state,
and upload receipt.

### `list_envelopes`

Lists envelopes newest first. Filters accept v2 statuses and the familiar
aliases `pending` → `in_progress` and `signed` → `completed`. Page size defaults
to 20 and is capped at 100.

### `extract_contract_data`

Returns `not_extracted` until the envelope is complete, then returns structured
parties, lifecycle and semantic dates, governing law, and labeled field values.

## Lifecycle

### `remind_signer`

Emails the next unsigned signer after the envelope has been approved and sent.
Atlas enforces reminder rate limits.

### `void_envelope`

Cancels a non-terminal envelope so it can no longer be signed. This tool is
marked destructive and accepts an optional reason.

## Reliability

Mutating tools accept `idempotency_key`; reuse the same value when retrying the
same intended operation. Atlas errors are returned as MCP tool errors with
stable API codes and actionable messages.