# DocDiffAI

Compare two business document versions and get a source-cited change report.

Docs: https://docdiffai.com/agents

Use this for consequential Word or PDF revisions (contracts, proposals, policy rewrites). Do not use it for code diffs.

Setup:
1. Preferred: connect with OAuth 2.1 using /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server, or register a public client at POST /oauth/register with PKCE S256.
2. Legacy: ask the human to sign in and click "Create MCP setup prompt" at https://docdiffai.com/account, then POST https://docdiffai.com/api/v1/bootstrap/exchange with {"token":"..."} and store the returned API key securely.

Auth for MCP: OAuth 2.1 Bearer access token (recommended) or Authorization: Bearer <api-key>

MCP (Streamable HTTP, stateless): POST /mcp
  tools: create_comparison, create_comparison_upload, get_comparison, unlock_comparison_report, get_comparison_report
  create_comparison accepts the attached older/newer PDF or Word files directly in ChatGPT desktop or web
  local filesystem paths are not ChatGPT attachments; ask the user to attach both files
  do not use create_comparison_upload in ChatGPT
  create_comparison_upload returns a short-lived browser upload URL only for non-ChatGPT MCP clients without file-parameter support
  get_comparison polls status and source coverage
  unlock_comparison_report unlocks a completed report when report access is available
  get_comparison_report reads an unlocked bounded summary plus paginated findings (default 25, max 50) and report_url; use cursor for additional pages

Optional REST fallback (requires a separately configured DocDiffAI API key; ChatGPT OAuth does not authorize these endpoints):
  POST /api/v1/comparisons with multipart fields before and after
  GET /api/v1/comparisons/:id for status, stage, and coverage
  GET /api/v1/comparisons/:id/report only for a report already unlocked through MCP
  Use REST only when MCP transport or tooling fails and the separate API key is already available. Never use REST to bypass credits_exhausted or another MCP access error.