Definely's MCP connector brings Definely's rules-based document analysis into the AI assistants you already use: upload an agreement, check defined and undefined terms, cross-references and drafting issues, search your Vault, and generate shareable reports without leaving the conversation.
What is the Definely MCP connector?
The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and data. Definely's MCP server exposes Definely's document intelligence as a set of tools that a compatible AI assistant can call on your behalf.
Definely provides the deterministic layer: structural certainty, control and procedural accuracy on top of general-purpose AI. The assistant decides which tools to call and explains the results, but the analysis itself is done by the same Definely engine that powers the Word add-in and web platform.
Important: the connector does not replace the Microsoft Word add-in. Word remains where legal documents are reviewed, finalised and executed. The connector extends Definely into new environments, with different use cases such as mobile review, bulk processing and cross-document analysis.
What can you do with it?
Capability | What it does |
Defined terms | Lists every capitalised or formally defined term in the document |
Undefined terms | Identifies terms used as if defined but never actually defined |
Cross-references | Maps what a clause refers to, and where a clause is referred to |
Document structure | Retrieves the table of contents and the text of individual clauses |
Proof | Summarises proofreading issues across the document, or within a specific clause |
Issues List | Generates a report from the comments, tracked changes and mark-up in the document |
Vault search | Searches your Vault for precedent clauses, definitions and documents, by name or by meaning |
Ask from document | Ask the assistant questions about the uploaded document, grounded in Definely's analysis |
Requirements
An active Definely licence.
A Definely account with valid credentials (the email address associated with your Definely licence).
A supported AI assistant.
Connecting
Setup differs by assistant. Choose your guide:
Whichever assistant you use, each user signs in individually with their own Definely credentials.
How a session works
Every Definely session follows the same three steps:
Upload. Ask the assistant to upload your document to Definely. For example: "Upload this NDA to Definely."
Prepare. The assistant prepares the document for analysis in the background. No other analysis tool can run until this completes.
Analyse. Run any of the tools below, in any order, as many times as you like.
You can chain requests in one message, for example: "Upload this agreement, then find all defined terms and flag any undefined ones."
Available tools
The connector exposes the following 22 tools. The assistant chooses between them based on your request, so you do not call them by name.
Upload and preparation
Tool | What it does |
| Starts an upload. Returns a secure upload location and file ID for your document. This is the first step of every session. |
| Prepares an uploaded document for analysis: runs the rules-based analysis and proofreading and indexes the document. Must complete before any other analysis tool is used. |
| Alternative upload route for assistants that cannot perform the standard upload themselves. Fetches an attached file and uploads it to Definely on the server side. |
| Opens an upload widget so you can pick a local file, in assistants that support it. |
Document structure
Tool | What it does |
| Returns a hierarchical outline of the document: its sections, clauses and subclauses. |
| Returns the items directly inside a given section, clause or schedule. |
| Returns the section or clause that contains a given item. |
| Returns the text of a specific document item. |
| Finds a section, clause or defined term by name and returns its text. |
Defined and undefined terms
Tool | What it does |
| Lists the defined terms in the document, with each occurrence listed separately. |
| Lists capitalised terms that are used as if defined but are not defined in the document. |
| Checks a piece of text, such as a draft clause, against the document and returns any terms in it that the document does not define. |
Cross-references
Tool | What it does |
| Returns the items that a given section refers to. |
| Returns the places in the document that refer to a given section. |
Proof
Tool | What it does |
| Returns a summary of proofreading issues in the document, grouped by type with counts. |
| Returns the individual proofreading issues within a given section or clause. |
Issues List
Tool | What it does |
| Generates an Issues List from the tracked changes, mark-up and comments in a prepared document. |
Vault
Tool | What it does |
| Searches your Vault for clauses and definitions by name (exact or partial). |
| Searches your Vault for clauses and definitions similar in meaning to a description or passage of text. |
| Finds a named Vault document and returns its structural outline. |
| Finds the Vault document most similar to your uploaded document and returns its structural outline, for comparison and gap analysis. |
Output styling
Tool | What it does |
| Returns Definely's design guidelines so reports the assistant generates, such as an Issues List, carry consistent styling. |
Bulk and multi-document work
The connector is not limited to the document open in Word. If your assistant can reach other documents, for example through a file-storage connector, you can run Definely across a set of documents, such as:
Cross-document consistency checks: verify that defined terms or party names are consistent across a document suite.
Bulk proof checks: run proofreading across every document in a folder.
Output formats
After any analysis you can ask the assistant to present the results as a conversational summary (the default), a table, a shareable HTML report, or a downloadable Word document. For example: "Put the results in HTML format."
Example prompts
Upload this contract to Definely and prepare it for analysis.
List all defined terms in this agreement.
Find all undefined or improperly defined terms in this contract.
Run a full cross-reference report on this document.
Generate the full issues list for this agreement.
Proof check the indemnity clause.
Search my vault for NDA templates.
Upload this agreement, run the full issues list, and summarise the top five problems.
Consistency and data handling
Analysis is deterministic and rules-based. Running the same analysis on the same document produces the same results every time. The assistant calls Definely's tools and reports what they return.
Definely analyses the documents you upload in the current session, and the connector can only access data the signed-in user is permitted to view in Definely. Any data sent to or processed by the AI assistant you connect is subject to your agreements with that provider; Definely is not responsible for how third-party assistants handle data once it has left Definely's systems.
Limitations
Make sure you upload the right version of a document.
Very large documents may take longer to process.
Definely identifies drafting issues but does not give legal advice. Professional judgement remains essential.
Vault results depend on what is stored in your Definely Vault.
The connector requires an active Definely licence and valid credentials.
Troubleshooting
The hosted MCP server is not available for this user Check with your Definely admin or representative that you are licensed for this product.
You don't have access to use this tool Your Definely account lacks the permission needed for that tool. For example, the Vault tools require access to Vault. Contact your Definely workspace administrator to review your access.
An ID or hash is rejected as invalid The assistant may have generated the identifier incorrectly. Ask it to try again; if it keeps failing, re-run the document upload and preparation steps.
Authentication fails or the token is rejected Verify your Definely account is active and that you have access to the MCP feature. Try re-authenticating by removing and re-adding the connector in your assistant.
Tools are not appearing in my assistant Re-authenticate if the connection was previously established.
Problems specific to one assistant are covered in that assistant's guide.
FAQ
Can multiple users connect to the same MCP server? Yes. Each user authenticates individually and the server enforces that user's own permissions and feature gates.
What data can the connector access? Only data the signed-in user has permission to view in Definely. Vault queries are scoped to what the user can access, and document analysis covers documents uploaded by the user in their session.
Does this support conversation history? Sessions are preserved in your assistant's conversation history. Documents must be re-uploaded to Definely if the retention period has expired.