Contracts

Every Contracts tool, with the scope it needs, its arguments and the API operation it calls.

43 tools

Get contract analytics

Read only

atlas_contracts_analytics_get

Return contracts analytics overview - status mix, kind mix, active value by currency, 30/60/90-day expiring counts, and renewal rate.

Scope: contracts:read
Calls: GET /v1/contracts/analytics/overview
Example prompt: Give me the contract portfolio overview for this month.

Arguments

Field	Type	Required	Description
`from`	`string (date-time)`	No	Optional ISO-8601 lower bound for contract createdAt.
`to`	`string (date-time)`	No	Optional ISO-8601 upper bound for contract createdAt.

List contract approvals

Read only

atlas_contracts_approvals_list

List the approval chain for a contract in sequence order with status and comments, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/approvals
Example prompt: Who has approved contract con_xyz so far?

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"sequence"`	No	The field to sort on: sequence. sequence by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Approve contracts

Changes data

atlas_contracts_approve

Record an approval on a contract under review with an optional comment.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/approve
Example prompt: Approve contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	No

Add contract approvers

Changes data

atlas_contracts_approvers_add

Add an approver to a contract with a sequence number and optional SLA in hours.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/approvals
Example prompt: Add legal as approver 1 on contract con_xyz with a 24h SLA.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id to attach the approver to.
`approverUserId`	`string`	Yes
`sequence`	`integer`	Yes
`slaHours`	`integer`	No

Archive contracts

Changes data

atlas_contracts_archive

Archive a contract (soft-hides it from the active list).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/archive
Example prompt: Archive contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contract audit events

Read only

atlas_contracts_audit_events_list

List the tamper-evident audit log for a contract in chronological order, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/audit
Example prompt: Show the audit trail for contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"at"`	No	The field to sort on: at. at by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Verify contract audit events

Read only

atlas_contracts_audit_events_verify

Verify the hash-chain integrity of a contract audit log (returns { ok, brokenAt? } for tamper detection).

Scope: contracts:read
Calls: GET /v1/contracts/{id}/audit/verify
Example prompt: Verify the audit chain on contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Request contract changes

Changes data

atlas_contracts_changes_request

Request changes on a contract under review (with a required comment explaining the asks).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/request-changes
Example prompt: Request changes on contract con_xyz: SLA must be 99.9.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	Yes

Add contract clauses

Changes data

atlas_contracts_clauses_add

Attach a library clause template to a specific contract.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/clauses
Example prompt: Attach the mutual-NDA clause to contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`clauseId`	`string`	Yes	Clause template id from the library to attach.

Create contract clauses

Changes data

atlas_contracts_clauses_create

Create a clause-library template (category, name, body, variables, risk level).

Scope: contracts:write
Calls: POST /v1/contracts/clauses
Example prompt: Add a new mutual-NDA confidentiality clause to the library.

Arguments

Field	Type	Required
`category`	`string`	Yes
`name`	`string`	Yes
`body`	`string`	Yes
`variables`	`array of object`	No
`riskLevel`	`"safe" \| "standard" \| "negotiated"`	No
`language`	`string`	No

List contract clauses

Read only

atlas_contracts_clauses_list

List clause-library templates, one page at a time. Optionally filter by category. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/clauses/library
Example prompt: What clause templates do we have for indemnification?

Arguments

Field	Type	Required	Description
`category`	`string`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"lastUpdatedAt" \| "name"`	No	The field to sort on: lastUpdatedAt, name. lastUpdatedAt by default.
`order`	`"asc" \| "desc"`	No	asc or desc. desc by default.

Update contract clauses

Changes data

atlas_contracts_clauses_update

Patch fields on a clause-library template.

Scope: contracts:write
Calls: PATCH /v1/contracts/clauses/{id}
Example prompt: Update the standard liability clause body.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`patch`	`object`	Yes	Fields to update on the clause template.

Create contracts

Changes data

atlas_contracts_create

Create a new contract (lands in draft). Capture title, kind, counterparties, term, value and tags.

Scope: contracts:write
Calls: POST /v1/contracts
Example prompt: Draft an MSA contract with Acme Corp, 12-month term.

Arguments

Field	Type	Required	Description
`title`	`string`	Yes
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No
`counterparties`	`array of object`	No
`valueAmount`	`number`	No
`valueCurrency`	`string`	No	ISO-4217 currency code.
`startsOn`	`string (date-time)`	No
`endsOn`	`string (date-time)`	No
`renewalDate`	`string (date-time)`	No
`autoRenewing`	`boolean`	No
`renewalNoticeDays`	`integer`	No
`governingLaw`	`string`	No
`paymentTerms`	`string`	No
`terminationClause`	`string`	No
`tags`	`array of string`	No

Decline contracts

Changes data

atlas_contracts_decline

Decline an approval slot on a contract under review (with a required reason comment).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/decline
Example prompt: Decline contract con_xyz: liability cap unacceptable.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	Yes

List contract expirations

Read only

atlas_contracts_expirations_list

List active contracts expiring inside the given look-ahead window, soonest first, with days remaining and value.

Scope: contracts:read
Calls: GET /v1/contracts/analytics/expiring
Example prompt: Which contracts expire in the next 60 days?

Arguments

Field	Type	Required	Description
`withinDays`	`integer`	No	Look-ahead window in days. Defaults to 90.

Submit contract external reviews

Changes data

atlas_contracts_external_reviews_submit

Move an internally approved contract into external review with the counterparty.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-external
Example prompt: Send contract con_xyz to the counterparty for review.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get contracts

Read only

atlas_contracts_get

Fetch a single contract by id, including counterparties, value, term dates, and current status.

Scope: contracts:read
Calls: GET /v1/contracts/{id}
Example prompt: Show me contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Submit contract internal reviews

Changes data

atlas_contracts_internal_reviews_submit

Move a draft contract into internal review (legal / finance sign-off pre-counterparty).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Send contract con_xyz to internal review.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contracts

Read only

atlas_contracts_list

List contracts in the tenant, one page at a time. Filter by status, owner, kind, or full-text search across title and counterparties. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts
Example prompt: Which contracts are out for signature right now?

Arguments

Field	Type	Required	Description
`status`	`"draft" \| "internal_review" \| "external_review" \| "out_for_signature" \| "active" \| "expired" \| "terminated" \| "archived"`	No
`ownerUserId`	`string`	No
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No
`search`	`string`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"updatedAt" \| "createdAt" \| "title"`	No	The field to sort on: updatedAt, createdAt, title. updatedAt by default.
`order`	`"asc" \| "desc"`	No	asc or desc. desc by default.

Extract contract metadata

Changes data

atlas_contracts_metadata_extract

Re-run the AI metadata extractor on a contract (term dates, value, governing law, etc.). Returns the updated contract.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/extract-metadata
Example prompt: Re-extract metadata for contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract obligations

Changes data

atlas_contracts_obligations_create

Create a new contract obligation (payment, deliverable, renewal, termination_notice, custom).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/obligations
Example prompt: Add a quarterly payment obligation to contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id the obligation belongs to.
`kind`	`"payment" \| "deliverable" \| "renewal" \| "termination_notice" \| "custom"`	Yes
`dueDate`	`string (date-time)`	Yes
`description`	`string`	Yes
`assigneeUserId`	`string`	No

List contract obligations

Read only

atlas_contracts_obligations_list

List obligations across all contracts, or one contract by contractId, soonest due first, one page at a time. Filter by status or upcoming-due flag. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/obligations
Example prompt: Which contract obligations are due in the next 30 days?

Arguments

Field	Type	Required	Description
`contractId`	`string`	No	List the obligations of this one contract only. Leave it out for every contract.
`status`	`"open" \| "met" \| "breached" \| "waived"`	No
`upcoming`	`boolean`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"dueDate"`	No	The field to sort on: dueDate. dueDate by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Update contract obligations

Changes data

atlas_contracts_obligations_update

Patch a contract obligation: status (open/met/breached/waived), description, due date or assignee.

Scope: contracts:write
Calls: PATCH /v1/contracts/obligations/{id}
Example prompt: Mark obligation obl_xyz as met.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Obligation id.
`status`	`"open" \| "met" \| "breached" \| "waived"`	No
`description`	`string`	No
`dueDate`	`string (date-time)`	No
`assigneeUserId`	`string`	No

Renew contracts

Changes data

atlas_contracts_renew

Renew an active contract in-place by setting a new end date (and optional new value).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/renew
Example prompt: Renew contract con_xyz for another 12 months.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`newEndsOn`	`string (date-time)`	Yes	ISO datetime of the new end of term.
`newValueAmount`	`number`	No

Accept contract renewals

Changes data

atlas_contracts_renewals_accept

Accept a sent renewal proposal (owner/admin only). Updates the underlying contract.

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/accept
Example prompt: Accept renewal rnw_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract renewals

Changes data

atlas_contracts_renewals_create

Propose a renewal for an existing contract (new end date, optional new value, internal notes).

Scope: contracts:write
Calls: POST /v1/contracts/{contractId}/renewals
Example prompt: Propose a 12-month renewal on contract con_xyz at 110k USD.

Arguments

Field	Type	Required	Description
`contractId`	`string`	Yes
`newEndsOn`	`string (date-time)`	Yes	Proposed new end-of-term datetime.
`newValueAmount`	`number`	No
`notes`	`string`	No

Get contract renewals

Read only

atlas_contracts_renewals_get

Fetch a single contract renewal proposal by id.

Scope: contracts:read
Calls: GET /v1/contracts/renewals/{id}
Example prompt: Show me renewal rnw_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contract renewals

Read only

atlas_contracts_renewals_list

List contract renewals. Use withinDays for the analytics feed (upcoming auto-renewals); otherwise filter renewal proposals by status or contract.

Scope: contracts:read
Calls: GET /v1/contracts/renewals
Example prompt: Which contracts auto-renew in the next 60 days?

Arguments

Field	Type	Required	Description
`withinDays`	`integer`	No	When set, returns contracts whose renewal/end falls within this many days (analytics feed).
`status`	`"PROPOSED" \| "SENT" \| "ACCEPTED" \| "REJECTED" \| "CANCELLED"`	No	Filter the renewal proposal list by status. Ignored when withinDays is set.
`contractId`	`string`	No	Filter the renewal proposal list to one contract. Ignored when withinDays is set.

Reject contract renewals

Changes data

atlas_contracts_renewals_reject

Reject a sent renewal proposal with a required reason (owner/admin only).

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/reject
Example prompt: Reject renewal rnw_xyz: pricing not aligned.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Send contract renewals

Destructive

atlas_contracts_renewals_send

Send a proposed renewal to the counterparty (transitions proposal to SENT).

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/send
Example prompt: Send renewal rnw_xyz to the counterparty.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Request contract signatures

Changes data

atlas_contracts_signatures_request

Send an approved contract out for signature (transitions to out_for_signature).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/send-for-signature
Example prompt: Send contract con_xyz out for signature.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract suite

Changes data

atlas_contracts_suite_create

Create a contract record. Returns the created contract with status draft.

Scope: contracts:write
Calls: POST /v1/contracts
Example prompt: Create a draft MSA contract for Acme.

Arguments

Field	Type	Required	Description
`title`	`string`	Yes	Short, human-readable contract title.
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No	Contract kind. Defaults to other.
`counterparties`	`array of object`	No	Parties to the contract. Defaults to none.
`valueAmount`	`number`	No	Contract value in major currency units (for example 12500.50), not cents.
`valueCurrency`	`string`	No	ISO-4217 currency code for valueAmount.
`startsOn`	`string (date-time)`	No	ISO-8601 date the contract takes effect.
`endsOn`	`string (date-time)`	No	ISO-8601 date the contract ends.
`renewalDate`	`string (date-time)`	No	ISO-8601 renewal date.
`autoRenewing`	`boolean`	No	Whether the contract renews automatically. Defaults to false.
`renewalNoticeDays`	`integer`	No	Days of notice needed before renewal.
`governingLaw`	`string`	No	Governing law, for example "England and Wales".
`paymentTerms`	`string`	No	Payment terms.
`terminationClause`	`string`	No	Termination clause text.
`tags`	`array of string`	No	Free-form tags.

Submit contract suite internal reviews

Changes data

atlas_contracts_suite_internal_reviews_submit

Submit a contract for internal approval. Returns the contract with its approval-request id and routing state.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Request approval for contract ctr_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`approverIds`	`array of string`	No	User ids to route the approval to.
`note`	`string`	No	Optional note to approvers.

Extract contract suite metadata

Changes data

atlas_contracts_suite_metadata_extract

Run AI metadata extraction over the contract body. Returns the extracted fields (parties, dates, value, renewal terms, etc.).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/extract-metadata
Example prompt: Extract metadata from contract ctr_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`fields`	`array of string`	No	Optional allow-list of fields to extract (e.g. parties, effectiveDate, renewalTerms).

Reject contract suite renewals

Changes data

atlas_contracts_suite_renewals_reject

Decline a proposed contract renewal. Notifies the requester and records the reason on the audit event. Returns the renewal with status: REJECTED.

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/reject
Example prompt: Decline renewal rnw_xyz: pricing out of band.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract renewal id.
`reason`	`string`	Yes	Why the renewal proposal is being declined. Recorded on the audit event.

Request contract suite signatures

Changes data

atlas_contracts_suite_signatures_request

Send an approved contract to its signers via the eSign workflow. Returns the contract with status: OUT_FOR_SIGNATURE.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/send-for-signature
Example prompt: Send ctr_xyz out for signature: approvals are all in.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id (e.g. ctr_...).

Terminate contract suite

Destructive

atlas_contracts_suite_terminate

Terminate an executed contract. Records the reason on the audit event. Returns the contract with status: TERMINATED.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/terminate
Example prompt: Terminate ctr_xyz: breach of payment terms.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id (e.g. ctr_...).
`reason`	`string`	Yes	Why the contract is being terminated. Recorded on the audit event.

Terminate contracts

Destructive

atlas_contracts_terminate

Terminate an active contract (with a required reason recorded on the audit log).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/terminate
Example prompt: Terminate contract con_xyz: customer churned.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Transition contracts

Changes data

atlas_contracts_transition

Move a contract to its next status: submit it for internal review, approve it, request changes, decline it, submit it to the counterparty, send it for signature, or terminate it. Returns the contract with its new status.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Send contract ctr_123 for signature now that the internal review approved it.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`transition`	`"submit-internal" \| "approve" \| "request-changes" \| "decline" \| "submit-external" \| "send-for-signature" \| "terminate"`	Yes	The step to take: submit-internal, approve, request-changes, decline, submit-external, send-for-signature, or terminate. The API answers 409 when the step is not open from the current status.
`comment`	`string`	No	Why. Required to request changes, to decline, and to terminate (recorded as the reason). Optional when approving.

Update contracts

Changes data

atlas_contracts_update

Patch fields on an existing contract (any subset of the create payload).

Scope: contracts:write
Calls: PATCH /v1/contracts/{id}
Example prompt: Update contract con_xyz to add a new counterparty.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`patch`	`object`	Yes	Fields to update.

Compare contract versions

Read only

atlas_contracts_versions_compare

Compute the redline diff between two contract versions (from -> to).

Scope: contracts:read
Calls: GET /v1/contracts/{id}/redline
Example prompt: Show me the redline between v1 and v3 of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`from`	`integer`	Yes	Earlier version number.
`to`	`integer`	Yes	Later version number.

Create contract versions

Changes data

atlas_contracts_versions_create

Record a new contract version by file SHA-256 (call after storing the file in object storage).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/versions
Example prompt: Upload v3 of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id the new version belongs to.
`fileSha256`	`string`	Yes	SHA-256 hex digest of the uploaded file.
`comment`	`string`	No

List contract versions

Read only

atlas_contracts_versions_list

List the versions of a contract in upload order (oldest first), one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/versions
Example prompt: List versions of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"versionNumber" \| "uploadedAt"`	No	The field to sort on: versionNumber, uploadedAt. versionNumber by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Tools reference

Contracts

Every Contracts tool, with the scope it needs, its arguments and the API operation it calls.

43 tools

Get contract analytics

Read only

atlas_contracts_analytics_get

Return contracts analytics overview - status mix, kind mix, active value by currency, 30/60/90-day expiring counts, and renewal rate.

Scope: contracts:read
Calls: GET /v1/contracts/analytics/overview
Example prompt: Give me the contract portfolio overview for this month.

Arguments

Field	Type	Required	Description
`from`	`string (date-time)`	No	Optional ISO-8601 lower bound for contract createdAt.
`to`	`string (date-time)`	No	Optional ISO-8601 upper bound for contract createdAt.

List contract approvals

Read only

atlas_contracts_approvals_list

List the approval chain for a contract in sequence order with status and comments, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/approvals
Example prompt: Who has approved contract con_xyz so far?

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"sequence"`	No	The field to sort on: sequence. sequence by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Approve contracts

Changes data

atlas_contracts_approve

Record an approval on a contract under review with an optional comment.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/approve
Example prompt: Approve contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	No

Add contract approvers

Changes data

atlas_contracts_approvers_add

Add an approver to a contract with a sequence number and optional SLA in hours.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/approvals
Example prompt: Add legal as approver 1 on contract con_xyz with a 24h SLA.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id to attach the approver to.
`approverUserId`	`string`	Yes
`sequence`	`integer`	Yes
`slaHours`	`integer`	No

Archive contracts

Changes data

atlas_contracts_archive

Archive a contract (soft-hides it from the active list).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/archive
Example prompt: Archive contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contract audit events

Read only

atlas_contracts_audit_events_list

List the tamper-evident audit log for a contract in chronological order, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/audit
Example prompt: Show the audit trail for contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"at"`	No	The field to sort on: at. at by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Verify contract audit events

Read only

atlas_contracts_audit_events_verify

Verify the hash-chain integrity of a contract audit log (returns { ok, brokenAt? } for tamper detection).

Scope: contracts:read
Calls: GET /v1/contracts/{id}/audit/verify
Example prompt: Verify the audit chain on contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Request contract changes

Changes data

atlas_contracts_changes_request

Request changes on a contract under review (with a required comment explaining the asks).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/request-changes
Example prompt: Request changes on contract con_xyz: SLA must be 99.9.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	Yes

Add contract clauses

Changes data

atlas_contracts_clauses_add

Attach a library clause template to a specific contract.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/clauses
Example prompt: Attach the mutual-NDA clause to contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`clauseId`	`string`	Yes	Clause template id from the library to attach.

Create contract clauses

Changes data

atlas_contracts_clauses_create

Create a clause-library template (category, name, body, variables, risk level).

Scope: contracts:write
Calls: POST /v1/contracts/clauses
Example prompt: Add a new mutual-NDA confidentiality clause to the library.

Arguments

Field	Type	Required
`category`	`string`	Yes
`name`	`string`	Yes
`body`	`string`	Yes
`variables`	`array of object`	No
`riskLevel`	`"safe" \| "standard" \| "negotiated"`	No
`language`	`string`	No

List contract clauses

Read only

atlas_contracts_clauses_list

List clause-library templates, one page at a time. Optionally filter by category. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/clauses/library
Example prompt: What clause templates do we have for indemnification?

Arguments

Field	Type	Required	Description
`category`	`string`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"lastUpdatedAt" \| "name"`	No	The field to sort on: lastUpdatedAt, name. lastUpdatedAt by default.
`order`	`"asc" \| "desc"`	No	asc or desc. desc by default.

Update contract clauses

Changes data

atlas_contracts_clauses_update

Patch fields on a clause-library template.

Scope: contracts:write
Calls: PATCH /v1/contracts/clauses/{id}
Example prompt: Update the standard liability clause body.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`patch`	`object`	Yes	Fields to update on the clause template.

Create contracts

Changes data

atlas_contracts_create

Create a new contract (lands in draft). Capture title, kind, counterparties, term, value and tags.

Scope: contracts:write
Calls: POST /v1/contracts
Example prompt: Draft an MSA contract with Acme Corp, 12-month term.

Arguments

Field	Type	Required	Description
`title`	`string`	Yes
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No
`counterparties`	`array of object`	No
`valueAmount`	`number`	No
`valueCurrency`	`string`	No	ISO-4217 currency code.
`startsOn`	`string (date-time)`	No
`endsOn`	`string (date-time)`	No
`renewalDate`	`string (date-time)`	No
`autoRenewing`	`boolean`	No
`renewalNoticeDays`	`integer`	No
`governingLaw`	`string`	No
`paymentTerms`	`string`	No
`terminationClause`	`string`	No
`tags`	`array of string`	No

Decline contracts

Changes data

atlas_contracts_decline

Decline an approval slot on a contract under review (with a required reason comment).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/decline
Example prompt: Decline contract con_xyz: liability cap unacceptable.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`comment`	`string`	Yes

List contract expirations

Read only

atlas_contracts_expirations_list

List active contracts expiring inside the given look-ahead window, soonest first, with days remaining and value.

Scope: contracts:read
Calls: GET /v1/contracts/analytics/expiring
Example prompt: Which contracts expire in the next 60 days?

Arguments

Field	Type	Required	Description
`withinDays`	`integer`	No	Look-ahead window in days. Defaults to 90.

Submit contract external reviews

Changes data

atlas_contracts_external_reviews_submit

Move an internally approved contract into external review with the counterparty.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-external
Example prompt: Send contract con_xyz to the counterparty for review.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get contracts

Read only

atlas_contracts_get

Fetch a single contract by id, including counterparties, value, term dates, and current status.

Scope: contracts:read
Calls: GET /v1/contracts/{id}
Example prompt: Show me contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Submit contract internal reviews

Changes data

atlas_contracts_internal_reviews_submit

Move a draft contract into internal review (legal / finance sign-off pre-counterparty).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Send contract con_xyz to internal review.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contracts

Read only

atlas_contracts_list

List contracts in the tenant, one page at a time. Filter by status, owner, kind, or full-text search across title and counterparties. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts
Example prompt: Which contracts are out for signature right now?

Arguments

Field	Type	Required	Description
`status`	`"draft" \| "internal_review" \| "external_review" \| "out_for_signature" \| "active" \| "expired" \| "terminated" \| "archived"`	No
`ownerUserId`	`string`	No
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No
`search`	`string`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"updatedAt" \| "createdAt" \| "title"`	No	The field to sort on: updatedAt, createdAt, title. updatedAt by default.
`order`	`"asc" \| "desc"`	No	asc or desc. desc by default.

Extract contract metadata

Changes data

atlas_contracts_metadata_extract

Re-run the AI metadata extractor on a contract (term dates, value, governing law, etc.). Returns the updated contract.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/extract-metadata
Example prompt: Re-extract metadata for contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract obligations

Changes data

atlas_contracts_obligations_create

Create a new contract obligation (payment, deliverable, renewal, termination_notice, custom).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/obligations
Example prompt: Add a quarterly payment obligation to contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id the obligation belongs to.
`kind`	`"payment" \| "deliverable" \| "renewal" \| "termination_notice" \| "custom"`	Yes
`dueDate`	`string (date-time)`	Yes
`description`	`string`	Yes
`assigneeUserId`	`string`	No

List contract obligations

Read only

atlas_contracts_obligations_list

Scope: contracts:read
Calls: GET /v1/contracts/obligations
Example prompt: Which contract obligations are due in the next 30 days?

Arguments

Field	Type	Required	Description
`contractId`	`string`	No	List the obligations of this one contract only. Leave it out for every contract.
`status`	`"open" \| "met" \| "breached" \| "waived"`	No
`upcoming`	`boolean`	No
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"dueDate"`	No	The field to sort on: dueDate. dueDate by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

Update contract obligations

Changes data

atlas_contracts_obligations_update

Patch a contract obligation: status (open/met/breached/waived), description, due date or assignee.

Scope: contracts:write
Calls: PATCH /v1/contracts/obligations/{id}
Example prompt: Mark obligation obl_xyz as met.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Obligation id.
`status`	`"open" \| "met" \| "breached" \| "waived"`	No
`description`	`string`	No
`dueDate`	`string (date-time)`	No
`assigneeUserId`	`string`	No

Renew contracts

Changes data

atlas_contracts_renew

Renew an active contract in-place by setting a new end date (and optional new value).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/renew
Example prompt: Renew contract con_xyz for another 12 months.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`newEndsOn`	`string (date-time)`	Yes	ISO datetime of the new end of term.
`newValueAmount`	`number`	No

Accept contract renewals

Changes data

atlas_contracts_renewals_accept

Accept a sent renewal proposal (owner/admin only). Updates the underlying contract.

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/accept
Example prompt: Accept renewal rnw_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract renewals

Changes data

atlas_contracts_renewals_create

Propose a renewal for an existing contract (new end date, optional new value, internal notes).

Scope: contracts:write
Calls: POST /v1/contracts/{contractId}/renewals
Example prompt: Propose a 12-month renewal on contract con_xyz at 110k USD.

Arguments

Field	Type	Required	Description
`contractId`	`string`	Yes
`newEndsOn`	`string (date-time)`	Yes	Proposed new end-of-term datetime.
`newValueAmount`	`number`	No
`notes`	`string`	No

Get contract renewals

Read only

atlas_contracts_renewals_get

Fetch a single contract renewal proposal by id.

Scope: contracts:read
Calls: GET /v1/contracts/renewals/{id}
Example prompt: Show me renewal rnw_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List contract renewals

Read only

atlas_contracts_renewals_list

List contract renewals. Use withinDays for the analytics feed (upcoming auto-renewals); otherwise filter renewal proposals by status or contract.

Scope: contracts:read
Calls: GET /v1/contracts/renewals
Example prompt: Which contracts auto-renew in the next 60 days?

Arguments

Field	Type	Required	Description
`withinDays`	`integer`	No	When set, returns contracts whose renewal/end falls within this many days (analytics feed).
`status`	`"PROPOSED" \| "SENT" \| "ACCEPTED" \| "REJECTED" \| "CANCELLED"`	No	Filter the renewal proposal list by status. Ignored when withinDays is set.
`contractId`	`string`	No	Filter the renewal proposal list to one contract. Ignored when withinDays is set.

Reject contract renewals

Changes data

atlas_contracts_renewals_reject

Reject a sent renewal proposal with a required reason (owner/admin only).

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/reject
Example prompt: Reject renewal rnw_xyz: pricing not aligned.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Send contract renewals

Destructive

atlas_contracts_renewals_send

Send a proposed renewal to the counterparty (transitions proposal to SENT).

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/send
Example prompt: Send renewal rnw_xyz to the counterparty.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Request contract signatures

Changes data

atlas_contracts_signatures_request

Send an approved contract out for signature (transitions to out_for_signature).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/send-for-signature
Example prompt: Send contract con_xyz out for signature.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create contract suite

Changes data

atlas_contracts_suite_create

Create a contract record. Returns the created contract with status draft.

Scope: contracts:write
Calls: POST /v1/contracts
Example prompt: Create a draft MSA contract for Acme.

Arguments

Field	Type	Required	Description
`title`	`string`	Yes	Short, human-readable contract title.
`kind`	`"msa" \| "sow" \| "nda" \| "dpa" \| "employment" \| "partnership" \| "vendor" \| "customer" \| "other"`	No	Contract kind. Defaults to other.
`counterparties`	`array of object`	No	Parties to the contract. Defaults to none.
`valueAmount`	`number`	No	Contract value in major currency units (for example 12500.50), not cents.
`valueCurrency`	`string`	No	ISO-4217 currency code for valueAmount.
`startsOn`	`string (date-time)`	No	ISO-8601 date the contract takes effect.
`endsOn`	`string (date-time)`	No	ISO-8601 date the contract ends.
`renewalDate`	`string (date-time)`	No	ISO-8601 renewal date.
`autoRenewing`	`boolean`	No	Whether the contract renews automatically. Defaults to false.
`renewalNoticeDays`	`integer`	No	Days of notice needed before renewal.
`governingLaw`	`string`	No	Governing law, for example "England and Wales".
`paymentTerms`	`string`	No	Payment terms.
`terminationClause`	`string`	No	Termination clause text.
`tags`	`array of string`	No	Free-form tags.

Submit contract suite internal reviews

Changes data

atlas_contracts_suite_internal_reviews_submit

Submit a contract for internal approval. Returns the contract with its approval-request id and routing state.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Request approval for contract ctr_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`approverIds`	`array of string`	No	User ids to route the approval to.
`note`	`string`	No	Optional note to approvers.

Extract contract suite metadata

Changes data

atlas_contracts_suite_metadata_extract

Run AI metadata extraction over the contract body. Returns the extracted fields (parties, dates, value, renewal terms, etc.).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/extract-metadata
Example prompt: Extract metadata from contract ctr_123.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`fields`	`array of string`	No	Optional allow-list of fields to extract (e.g. parties, effectiveDate, renewalTerms).

Reject contract suite renewals

Changes data

atlas_contracts_suite_renewals_reject

Decline a proposed contract renewal. Notifies the requester and records the reason on the audit event. Returns the renewal with status: REJECTED.

Scope: contracts:write
Calls: POST /v1/contracts/renewals/{id}/reject
Example prompt: Decline renewal rnw_xyz: pricing out of band.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract renewal id.
`reason`	`string`	Yes	Why the renewal proposal is being declined. Recorded on the audit event.

Request contract suite signatures

Changes data

atlas_contracts_suite_signatures_request

Send an approved contract to its signers via the eSign workflow. Returns the contract with status: OUT_FOR_SIGNATURE.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/send-for-signature
Example prompt: Send ctr_xyz out for signature: approvals are all in.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id (e.g. ctr_...).

Terminate contract suite

Destructive

atlas_contracts_suite_terminate

Terminate an executed contract. Records the reason on the audit event. Returns the contract with status: TERMINATED.

Scope: contracts:write
Calls: POST /v1/contracts/{id}/terminate
Example prompt: Terminate ctr_xyz: breach of payment terms.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id (e.g. ctr_...).
`reason`	`string`	Yes	Why the contract is being terminated. Recorded on the audit event.

Terminate contracts

Destructive

atlas_contracts_terminate

Terminate an active contract (with a required reason recorded on the audit log).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/terminate
Example prompt: Terminate contract con_xyz: customer churned.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Transition contracts

Changes data

atlas_contracts_transition

Scope: contracts:write
Calls: POST /v1/contracts/{id}/submit-internal
Example prompt: Send contract ctr_123 for signature now that the internal review approved it.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id.
`transition`	`"submit-internal" \| "approve" \| "request-changes" \| "decline" \| "submit-external" \| "send-for-signature" \| "terminate"`	Yes	The step to take: submit-internal, approve, request-changes, decline, submit-external, send-for-signature, or terminate. The API answers 409 when the step is not open from the current status.
`comment`	`string`	No	Why. Required to request changes, to decline, and to terminate (recorded as the reason). Optional when approving.

Update contracts

Changes data

atlas_contracts_update

Patch fields on an existing contract (any subset of the create payload).

Scope: contracts:write
Calls: PATCH /v1/contracts/{id}
Example prompt: Update contract con_xyz to add a new counterparty.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`patch`	`object`	Yes	Fields to update.

Compare contract versions

Read only

atlas_contracts_versions_compare

Compute the redline diff between two contract versions (from -> to).

Scope: contracts:read
Calls: GET /v1/contracts/{id}/redline
Example prompt: Show me the redline between v1 and v3 of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`from`	`integer`	Yes	Earlier version number.
`to`	`integer`	Yes	Later version number.

Create contract versions

Changes data

atlas_contracts_versions_create

Record a new contract version by file SHA-256 (call after storing the file in object storage).

Scope: contracts:write
Calls: POST /v1/contracts/{id}/versions
Example prompt: Upload v3 of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Contract id the new version belongs to.
`fileSha256`	`string`	Yes	SHA-256 hex digest of the uploaded file.
`comment`	`string`	No

List contract versions

Read only

atlas_contracts_versions_list

List the versions of a contract in upload order (oldest first), one page at a time. Returns a nextCursor; pass it back as cursor for the next page.

Scope: contracts:read
Calls: GET /v1/contracts/{id}/versions
Example prompt: List versions of contract con_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`limit`	`integer`	No	How many rows to return, 1 to 100. 50 by default.
`cursor`	`string`	No	The nextCursor of the previous page. Leave it out for the first page.
`sort`	`"versionNumber" \| "uploadedAt"`	No	The field to sort on: versionNumber, uploadedAt. versionNumber by default.
`order`	`"asc" \| "desc"`	No	asc or desc. asc by default.

You are in control of your cookies

Contracts

Get contract analytics

Arguments

List contract approvals

Arguments

Approve contracts

Arguments

Add contract approvers

Arguments

Archive contracts

Arguments

List contract audit events

Arguments

Verify contract audit events

Arguments

Request contract changes

Arguments

Add contract clauses

Arguments

Create contract clauses

Arguments

List contract clauses

Arguments

Update contract clauses

Arguments

Create contracts

Arguments

Decline contracts

Arguments

List contract expirations

Arguments

Submit contract external reviews

Arguments

Get contracts

Arguments

Submit contract internal reviews

Arguments

List contracts

Arguments

Extract contract metadata

Arguments

Create contract obligations

Arguments

List contract obligations

Arguments

Update contract obligations

Arguments

Renew contracts

Arguments

Accept contract renewals

Arguments

Create contract renewals

Arguments

Get contract renewals

Arguments

List contract renewals

Arguments

Reject contract renewals

Arguments

Send contract renewals

Arguments

Request contract signatures

Arguments

Create contract suite

Arguments

Submit contract suite internal reviews

Arguments

Extract contract suite metadata

Arguments

Reject contract suite renewals

Arguments

Request contract suite signatures

Arguments

Terminate contract suite

Arguments

Terminate contracts

Arguments

Transition contracts

Arguments