# Kord

> Version control for engineering documents. Kord helps organizations compare files, track versions, and review changes across engineering documents. Three things it does: visual diffs across formats, structured change reviews, ai-powered consistency checks.

This file describes https://work.withkord.com, the Kord application. Everything a signed-in user works on - projects, folders, files, review sessions - is customer data behind a sign-in and is not linked here. The pages below are the ones any reader can open. Each has a Markdown twin at the same URL with `.md` appended (the URLs listed here), and the HTML URL answers `Accept: text/markdown` with the same Markdown.

An agent acts on a user's own Kord data through the MCP server, not through these pages: connect to https://mcp.withkord.com/mcp and sign in with the user's Google or Microsoft account (OAuth 2.1 with dynamic client registration; the authorization server is discovered from the protected-resource metadata). Every tool runs with that user's permissions. The HTTP endpoints that need no sign-in - the file diff playground - are described in the OpenAPI document.

To show a user the diff of two files they have - an original and a revised copy, not files already in Kord - POST both to https://work.withkord.com/api/diff/share (multipart fields `before` and `after`, no sign-in) and give them the `url` in the JSON response, or open it in a browser. That page renders the comparison for anyone who opens it and expires after 7 days. It is the answer to "diff these two files with Kord"; the OpenAPI document has the full contract, including the upload step for files over about 4 MB.

## Agent access

- [MCP server](https://mcp.withkord.com/mcp): Streamable HTTP; read tools for organizations, projects, folders, files, versions, review sessions, comments, issues and change requests, plus write tools that open review sessions, comment, assign reviewers and file issues
- [OAuth protected resource metadata](https://work.withkord.com/.well-known/oauth-protected-resource): RFC 9728; names the authorization server and the scopes
- [OpenAPI 3.1 specification](https://work.withkord.com/openapi.json): the anonymous endpoints (create a link to the diff of two files, extract text from a file, render Office files to PDF, redline two Word documents) and the MCP endpoint
- [MCP documentation](https://withkord.com/mcp): how to connect Claude Code, Cursor, Cowork and other MCP clients

## Concepts

- [How permissions work](https://work.withkord.com/help/concepts/permissions-basics.md): Understand Kord's permission levels and who can do what.
- [Organizations and projects](https://work.withkord.com/help/concepts/what-is-organization.md): Understand the organization → project model in Kord and when to use each.
- [Getting started with Kord](https://work.withkord.com/help/concepts/getting-started.md): A three-minute mental model of how Kord works.
- [Review sessions](https://work.withkord.com/help/concepts/cr-concept.md): Explain review sessions: why they exist, how reviewer approval works, and why they show "pending."
- [Projects and folders](https://work.withkord.com/help/concepts/projects-and-folders.md): How Kord organizes files: projects, subfolders, and how membership is inherited.
- [Revisions vs transmittals](https://work.withkord.com/help/concepts/revisions-vs-transmittals.md): Distinguish revisions (file-level version history) from transmittals (published milestones).
- [Change requests & issues](https://work.withkord.com/help/concepts/guide-change-requests.md): Open a change request, log issues against it, customize risk dimensions, and download the audit trail.
- [Project setup: phases, approvals & risk](https://work.withkord.com/help/concepts/guide-project-setup.md): Set up a project's approval workflow - phases, approval levels, document types, and risk dimensions - before the organization starts work.
- [Reviewing documents end-to-end](https://work.withkord.com/help/concepts/guide-docs-review.md): Import a cloud folder, sync into a review session, comment and diff, add reviewers, publish approved revisions, and compare file versions.
- [Transmittals overview](https://work.withkord.com/help/concepts/guide-transmittal.md): Stage a transmittal, auto-assign Egnyte metadata, and generate a transmittal letter of transmittal to issue files.
- [Using Kord AI during review](https://work.withkord.com/help/concepts/guide-ai.md): Use Kord AI to check documents for inconsistencies, turn findings into issues, and summarize what changed in a review session.

## How-Tos

- [Stack a file onto another file's history](https://work.withkord.com/help/how-tos/link-to-history.md): Stack a file that synced in under a new name onto an existing file's version history even though the filename changed.
- [Download a PDF with its markups](https://work.withkord.com/help/how-tos/download-pdf-with-markups.md): Download a PDF that includes the visual markups (rectangles, arrows, clouds, comments) as annotations you can show or hide in your own PDF reader.
- [Invite a member to your organization](https://work.withkord.com/help/how-tos/invite-member.md): Invite someone to your organization so they get access to every project and folder under it.
- [Ask for access to a project](https://work.withkord.com/help/how-tos/request-project-access.md): Get access to a project in your organization that you have not been added to.
- [Give someone access to a project](https://work.withkord.com/help/how-tos/answer-access-request.md): Answer a request from a teammate who is asking to be added to one of your projects.
- [Find your transmittals](https://work.withkord.com/help/how-tos/where-are-transmittals.md): Find the transmittals for a project.
- [Create an organization](https://work.withkord.com/help/how-tos/create-organization.md): Create a new organization to collaborate with others and share projects.
- [Create a project](https://work.withkord.com/help/how-tos/create-project.md): Create a new project to track a folder of files in Kord.
- [Move a folder to another project](https://work.withkord.com/help/how-tos/move-folder-between-projects.md): Move a root folder, with its files and history, into a different project in the same organization.
- [Repair the cloud Published folder](https://work.withkord.com/help/how-tos/resync-published-folders.md): Rebuild a linked folder's cloud Published and Archive folders from Kord's record, or re-upload only the files whose last upload failed.
- [Make a subfolder a root folder](https://work.withkord.com/help/how-tos/hoist-subfolder-to-root.md): Lift a subfolder out of the folder above it so it becomes a folder of the project in its own right.
- [Archive or delete a project or organization](https://work.withkord.com/help/how-tos/archive-or-delete.md): Hide a project or organization you no longer need, and permanently delete it once you are sure.
- [Add a document number to a file](https://work.withkord.com/help/how-tos/add-document-number.md): Assign a document number to a file and view or export the project's documents.
- [Track the documents you owe, with deadlines](https://work.withkord.com/help/how-tos/track-deliverables.md): Add expected documents to a project before they exist - number, assignee and due date - and link each file as it lands.
- [Add your own column to the document register](https://work.withkord.com/help/how-tos/add-register-column.md): Add a project-specific column - Discipline, Package, Client Ref - to the Documents dashboard.
- [Sync the Documents dashboard with a Monday board](https://work.withkord.com/help/how-tos/connect-monday-board.md): Connect a Monday.com board to a project's Documents dashboard so document records and board items stay in step both ways.
- [Sign in to Monday.com](https://work.withkord.com/help/how-tos/connect-monday.md): Sign in to Monday.com from the organization page so you can connect boards to projects.
- [Have the AI fill in document numbers](https://work.withkord.com/help/how-tos/ai-fill-document-numbers.md): Use the AI assistant to assign document numbers (Doc #) and document types to files in bulk, following the numbering rule written in the project's AI instructions.
- [Set up the document numbering scheme](https://work.withkord.com/help/how-tos/configure-numbering-scheme.md): Define the segments a document number is built from - fixed codes, pick-lists, and typed-in values - so everyone assigns numbers the same way.
- [Link cloud storage to a new project](https://work.withkord.com/help/how-tos/link-cloud-storage.md): Connect a Google Drive, OneDrive, SharePoint, or Egnyte folder to Kord as a new project.
- [Compare another folder's files against this one](https://work.withkord.com/help/how-tos/review-folder-against-this.md): Compare a separate cloud folder - e.g. revised files a contractor dropped into a new folder - against this folder's files and open a review-only review session showing the diffs. Nothing is published.
- [Share a comparison with someone else](https://work.withkord.com/help/how-tos/share-a-diff.md): Create a link to a file comparison so a colleague, client, or subcontractor can open the same diff. Works for two file versions in Kord and for two files uploaded ad-hoc on the public /diff page.
- [Store your organization's files in your own AWS S3 bucket](https://work.withkord.com/help/how-tos/org-s3-bucket.md): Set one AWS S3 bucket for the whole organization: new projects use it automatically, and existing projects are moved onto it one at a time.
- [Create an issue](https://work.withkord.com/help/how-tos/create-issue.md): File an issue to track a problem, task, or follow-up inside a project.
- [Comment on a review session](https://work.withkord.com/help/how-tos/add-comment-to-cr.md): Add a comment or @mention a member on a review session.
- [Create a review session](https://work.withkord.com/help/how-tos/create-review-session.md): Open a new review session that proposes file changes for approval - the primary way to bundle synced cloud edits, stacked revisions, or a new uploaded version into something reviewers sign off on before it publishes.
- [Review a review session - approve or request changes](https://work.withkord.com/help/how-tos/review-a-review-session.md): Give a reviewer verdict: approve, approve with conditions you trust the author to make, or request changes that block publishing.
- [Mark up a drawing](https://work.withkord.com/help/how-tos/markup-drawing.md): Cloud, redline, and snapshot symbols on an engineering drawing during review.
- [Import a symbol library](https://work.withkord.com/help/how-tos/import-symbol-library.md): Add reusable markup symbols to a project by importing a Bluebeam .btx tool set or a folder of SVGs.
- [Stage a transmittal](https://work.withkord.com/help/how-tos/stage-transmittal.md): Stage a transmittal - a curated snapshot of files to send externally.
- [Download a transmittal package](https://work.withkord.com/help/how-tos/create-transmittal.md): Download a transmittal package (file versions + DOCX letter of transmittal).
- [Resync a file from cloud storage](https://work.withkord.com/help/how-tos/resync-file.md): Pull the latest version of a linked cloud file back into Kord.
- [See a file's full version history](https://work.withkord.com/help/how-tos/revision-history.md): Look at every past revision of a file and who approved each one.
- [Create an Engineering Change Request (ECR)](https://work.withkord.com/help/how-tos/create-ecr.md): Open a formal change request with risk assessment and an approval chain (ISO 9001 change management).
- [Start executing an approved change request](https://work.withkord.com/help/how-tos/promote-ecr-to-eco.md): After an ECR is approved, link the review sessions that implement the change and optionally assign closure approvers.
- [Link an issue to a change request](https://work.withkord.com/help/how-tos/link-issue-to-eco.md): Link an issue to the change request (ECR/ECO) that resolves it by dragging it on the project Tasks board, and unlink it the same way.
- [Approve a change request](https://work.withkord.com/help/how-tos/sign-off-eco.md): Approve, defer, or reject a change request from the Overall Decision panel - open to any organization member, captured in the activity log.
- [Download an ISO 9001 audit packet](https://work.withkord.com/help/how-tos/download-audit-packet.md): Generate the PDF evidence packet that documents a change - for one change request or for the whole folder (ECR proposals, evaluator recommendations, ECO execution records, linked review session approvals, activity log).
- [Upgrade your plan or manage billing](https://work.withkord.com/help/how-tos/upgrade-your-plan.md): Upgrade your organization to a paid plan, add a payment method, change seats, or manage billing in Kord.
- [Customize a folder's risk dimensions](https://work.withkord.com/help/how-tos/customize-risk-dimensions.md): Change the set of risk dimensions (schedule / technical / cost, etc.) that change requests are assessed against in a folder.
- [Set up a project's approval workflow](https://work.withkord.com/help/how-tos/set-up-approval-workflow.md): Define approval levels and project phases.
- [Auto-assign document metadata on a transmittal (Egnyte)](https://work.withkord.com/help/how-tos/assign-transmittal-metadata.md): Prefill document-control metadata (number, revision, status) with AI and push it to Egnyte for every file in a transmittal.
- [Check documents for inconsistencies with AI](https://work.withkord.com/help/how-tos/ai-inconsistency-check.md): Ask Kord AI to scan documents for conflicting values and turn each finding into a tracked issue with a suggested fix.
- [Set a due date on a review session](https://work.withkord.com/help/how-tos/set-review-session-due-date.md): Put a deadline on a review session so reviewers are reminded before it and everyone sees when it slips.
- [Sync docx comments with the shared drive](https://work.withkord.com/help/how-tos/push-comments-to-drive.md): Sync review comments on a Word document both ways between Kord and the copy that lives in Google Drive or Egnyte - Kord comments become native Word comments in the cloud copy, and comments made in Word flow back into Kord.
- [Add a chart to the project](https://work.withkord.com/help/how-tos/create-project-chart.md): Create a chart on the project's Charts tab by describing it in plain language
- [Comment on a rung, tag or block in a Logix project](https://work.withkord.com/help/how-tos/comment-on-a-plc-rung.md): Leave a review comment anchored to a specific rung, single instruction, Structured Text line, tag row, table cell, span of rungs or function-block element inside an .ACD or .L5X Studio 5000 project.
- [Comment on an object in a FactoryTalk View display](https://work.withkord.com/help/how-tos/comment-on-an-hmi-object.md): Leave a review comment anchored to one object of a FactoryTalk View display - a faceplate, a numeric or string field, a button, an indicator - so the comment follows the object when the screen is re-laid-out.
- [Review a ReqIF requirements baseline](https://work.withkord.com/help/how-tos/review-a-requirements-baseline.md): Read a ReqIF requirements baseline (a DOORS, Polarion, Jama or Codebeamer export) in Kord and review what changed between two revisions requirement by requirement.
- [Review a G-code toolpath](https://work.withkord.com/help/how-tos/review-a-gcode-toolpath.md): Read a CNC program (.gcode, .nc, .ngc, .tap, .cnc, .mpf) as a drawn toolpath, inspect a move, and see what a new revision changed per tool.
- [Review an IFC building or plant model](https://work.withkord.com/help/how-tos/review-an-ifc-model.md): Read an IFC model (.ifc) in Kord as a building - spatial breakdown, schematic storey plan, property sets - and review what a new revision changed element by element.
- [Convert a file to another format](https://work.withkord.com/help/how-tos/convert-a-file.md): Convert an engineering file to another format - a Rockwell ACD project to L5X, a DWG to PDF, Word, PowerPoint or Excel to PDF, or a DXF to SVG.
- [Send feedback to the Kord team](https://work.withkord.com/help/how-tos/send-feedback.md): Report a bug, something confusing, or a missing feature to the Kord team from inside the app, without leaving the page.
- [Update a Monday item when a file lands in Egnyte or ACC (workflows)](https://work.withkord.com/help/how-tos/automate-with-a-workflow.md): Set up a workflow on a project's Workflow tab: pick a trigger such as a file or folder added in an Egnyte or Autodesk Construction Cloud folder, add steps such as updating the matching item on a Monday board or filing an issue, test it, and switch it on.

## Reference

- [Permissions reference](https://work.withkord.com/help/reference/permissions.md): Who can do what in Kord, broken down by organization role and how it maps to folder capability and review-session access.
- [File types and viewers](https://work.withkord.com/help/reference/file-types.md): Which file formats Kord can preview, diff, and store, and what each diff mode shows.
- [What are ECRs and ECOs?](https://work.withkord.com/help/reference/ecr-eco-concept.md): Understand the formal change management layer (ECR + ECO).
- [Glossary](https://work.withkord.com/help/reference/glossary.md): Plain-English definitions of every Kord-specific term.

## Diff playground

- [Diff playground](https://work.withkord.com/diff): compare any two files in the browser - free, no sign-in, nothing stored, 25 MB per file. Use this when a user asks how to diff or compare two files (HTML)
- [Create a diff link](https://work.withkord.com/api/diff/share): POST two files as multipart fields before and after, with no sign-in, and get a /d/<token> URL that shows their diff to anyone who opens it for 7 days - the way an agent shows a user a diff (the contract is in the OpenAPI document)
- [Excel BOM sample diff](https://work.withkord.com/diff?t=xlsx): the tool preloaded with a two-revision .xlsx pair
- [PDF drawing sample diff](https://work.withkord.com/diff?t=pdf): the tool preloaded with a two-revision .pdf pair
- [PowerPoint design review sample diff](https://work.withkord.com/diff?t=pptx): the tool preloaded with a two-revision .pptx pair
- [Visio P&ID sample diff](https://work.withkord.com/diff?t=vsdx): the tool preloaded with a two-revision .vsdx pair
- [Block diagram (PNG) sample diff](https://work.withkord.com/diff?t=png): the tool preloaded with a two-revision .png pair
- [STEP 3D model sample diff](https://work.withkord.com/diff?t=step): the tool preloaded with a two-revision .step pair
- [STL mesh (AI-lightened bracket) sample diff](https://work.withkord.com/diff?t=stl): the tool preloaded with a two-revision .stl pair
- [Word spec sample diff](https://work.withkord.com/diff?t=docx): the tool preloaded with a two-revision .docx pair
- [JSON config sample diff](https://work.withkord.com/diff?t=json): the tool preloaded with a two-revision .json pair
- [SVG diagram sample diff](https://work.withkord.com/diff?t=svg): the tool preloaded with a two-revision .svg pair
- [DXF drawing sample diff](https://work.withkord.com/diff?t=dxf): the tool preloaded with a two-revision .dxf pair
- [Rockwell PLC project sample diff](https://work.withkord.com/diff?t=l5x): the tool preloaded with a two-revision .l5x pair
- [ReqIF requirements sample diff](https://work.withkord.com/diff?t=reqif): the tool preloaded with a two-revision .reqif pair
- [CNC toolpath (G-code) sample diff](https://work.withkord.com/diff?t=nc): the tool preloaded with a two-revision .nc pair
- [NASTRAN wing rib sample diff](https://work.withkord.com/diff?t=bdf): the tool preloaded with a two-revision .bdf pair
- [DEXPI P&ID (amine contactor) sample diff](https://work.withkord.com/diff?t=dexpi): the tool preloaded with a two-revision .dexpi pair
- [PSS/E power-flow case sample diff](https://work.withkord.com/diff?t=raw): the tool preloaded with a two-revision .raw pair
- [IEC 61850 substation sample diff](https://work.withkord.com/diff?t=scd): the tool preloaded with a two-revision .scd pair
- [Gerber PCB copper sample diff](https://work.withkord.com/diff?t=gtl): the tool preloaded with a two-revision .gtl pair
- [KiCad schematic sample diff](https://work.withkord.com/diff?t=kicad_sch): the tool preloaded with a two-revision .kicad_sch pair
- [KiCad PCB layout sample diff](https://work.withkord.com/diff?t=kicad_pcb): the tool preloaded with a two-revision .kicad_pcb pair
- [Simulink model sample diff](https://work.withkord.com/diff?t=slx): the tool preloaded with a two-revision .slx pair
- [Modelica model sample diff](https://work.withkord.com/diff?t=mo): the tool preloaded with a two-revision .mo pair
- [OpenRocket design sample diff](https://work.withkord.com/diff?t=ork): the tool preloaded with a two-revision .ork pair
- [LTspice schematic sample diff](https://work.withkord.com/diff?t=asc): the tool preloaded with a two-revision .asc pair
- [IFC building model sample diff](https://work.withkord.com/diff?t=ifc): the tool preloaded with a two-revision .ifc pair
- [PLCopen controls program sample diff](https://work.withkord.com/diff?t=plcopen): the tool preloaded with a two-revision .plcopen pair
- [Format guides](https://withkord.com/compare): one page per format on the marketing site - what the comparison shows, alternatives, FAQ

## Optional

- [Home](https://work.withkord.com/index.md): what Kord is, in one page
- [Help index](https://work.withkord.com/help.md): the sections above, as one page
- [Plans](https://work.withkord.com/plans.md): Free, Team and Enterprise pricing
- [Security](https://work.withkord.com/security): infrastructure, encryption, access control and compliance (HTML)
- [Sign in](https://work.withkord.com/login): Google, Microsoft or email
- [Sitemap](https://work.withkord.com/sitemap.xml)
- [Marketing site](https://withkord.com)
- [Privacy policy](https://withkord.com/privacy)
- [Terms of service](https://withkord.com/terms)