Preview features - Wordsmith API

Preview. These features are available to organisations in the Wordsmith MCP and files pilot. Elsewhere they return 403 mcp_not_enabled. They are not listed in the navigation while the pilot runs, so keep this link to find them again.

What is in the preview

MCP server

Use Wordsmith from ChatGPT, Claude, Claude Code and other MCP hosts.

OAuth sign-in

Let users connect an app to Wordsmith without sharing an API key.

Files API

Add, read and download files, and attach them by file_id.

Reviews and documents

Review contracts, generate redlines, and compare, translate, redact, convert or merge files.

Reports and repositories

Keep documents in repositories, search them, and answer the same questions across all of them.

Areas in the preview

Area	Endpoints	What it does
Files	Complete Upload, Import File, Create File, Get File, Get File Text, Get File Download	Add files from an upload, a public URL or text, and read them back. Upload URL is available to everyone.
Operations	List Operations, Get Operation, Cancel Operation	Wait for, or stop, work that takes longer than one request.
Agents, playbooks and blueprints	Get Agent, Get Playbook, List Blueprints, Get Blueprint	Read one agent, a playbook with its checks, or a blueprint with its placeholders.
Sessions	List Sessions, Get Session, List Messages	Read past conversations.
Reviews	Create Review, List Reviews, Get Review, List Findings, Generate Redline	Review contracts against a playbook or your instructions, and get a tracked-changes redline.
Document actions	Compare Files, Merge Files, Redline File, Translate File, Redact File, Convert File, Accept Changes	Make a new file from files you have in Wordsmith.
Playbook authoring	Create Playbook, Update Playbook, Delete Playbook, Add Check, Update Check, Delete Check, Generate Playbook	Write playbooks and their checks, or generate one from examples or instructions.
Drafts	Create Draft	Draft a document from instructions, or fill a blueprint.
Research	Search Research Sources, Get Research Document	Search case law and legislation, and read one document.
Reports	List Reports, Create Report, Get Report, Run Report, List Cells, Export Report, and the column and row routes	Answer the same questions across many documents, and export the grid.
Repositories and search	List Repositories, Create Repository, Add Documents, Search Repository, Search Knowledge, and the document and folder routes	Keep documents in repositories and search them by meaning.
Sharing	Get Sharing, Update Sharing	See and change who can see a repository, report, playbook, blueprint or session.
Organisation	Get Member, List Roles, Get Team, List Invites, List Company Profiles, and the routes that change them	Read and administer members, roles, teams, invites and company profiles.
Usage and value	Get Usage Summary, Get Usage Breakdown, Get Usage Over Time	Sessions, active users, hours saved and cost saved.

Each area has an MCP tool that calls the same code.

Attaching a file by `file_id`

In the preview, an attachment on Create Question can name a file you already have, instead of uploading it again. Attach Files already takes file_ids for tasks.

{
  "question": "Summarise the termination rights in this agreement.",
  "attachments": [{ "file_id": "7c3e9a51-2d84-4f06-b1c7-5e9d0a2f8b63" }]
}

With an OAuth token, a file_id attachment needs the files:read scope as well as files:write.

​What is in the preview

MCP server

OAuth sign-in

Files API

Reviews and documents

Reports and repositories

​Areas in the preview

​Attaching a file by file_id

What is in the preview

Areas in the preview

Attaching a file by `file_id`