Managing Custom Data Items with an AI Agent (MCP)
Let an AI agent connected over MCP create and maintain your custom data items, add them to documents, set their values and turn {{Label}} placeholders into real merge fields.
An agent connected through the QuoteCloud MCP server can manage custom data items (merge fields) the same way you do in Settings → Custom Data Items and in the editor sidebar. Every write is bounded by the capability switches you turn on and recorded in your audit history.
Turn on the capabilities
Enable the switches
3 steps
Open the MCP add-on settings
Go to Settings → Add-ons → MCP and find the capability switches.
Enable Edit documents
This lets the agent add data items to a document, set their values and convert placeholders.
Enable Manage custom data items if needed
Only turn this on for connections you trust: it lets the agent create, rename, delete and restore the company-wide definitions every document can use. Deletes are reversible and a rename never changes documents that already hold the item.
What the agent can do
List definitions with their ids, scope (company-wide or scoped to one document) and the merge-field key, plus the built-in system items such as Document ID, Company Name or Recipient First Name.
Create a company-wide definition of any type (text, number, currency, date, date and time, yes/no, dropdown, multi-select or check box). The agent needs the same permission as the settings page: company owner or Manage company settings.
Change a definition. Changing the default, options or mandatory flag applies at once. Renaming asks you to confirm first and tells you how many templates and documents use the item.
Delete and restore. A delete always asks for confirmation and only hides the item; its stored values are kept, and the agent can restore it later.
Add a data item to a document, either an existing company-wide one or a new one that exists only on that document, optionally setting its value in the same call.
Remove a data item from a document. This asks for confirmation. A company-wide definition is only unlinked from that document; it is never changed.
Convert placeholders. Text written as
{{Project name}}in text blocks, table cells, headers or footers becomes a real merge field. The label must match exactly one item on the document (or a system item). If any placeholder cannot be matched, nothing is changed and the agent is told which labels failed.
Writing placeholders for an agent
When you draft a template for an agent to finish, write each merge field as {{Label}} using the exact label of the data item, including capitalisation. For built-in items use the unique label shown in the editor picker, for example {{Recipient First Name}} rather than {{First Name}}, which belongs to both the document owner and the recipient.
More in Document Templates
- Edit a TemplateLearn how to edit an existing template in QuoteCloud using the Document Editor to customize layouts, content, and design.
- Edit, Duplicate & Delete Existing Document TemplatesDiscover how to edit, duplicate, and delete Sales Quote templates in QuoteCloud. Manage your templates easily to keep your Sales Quotes up-to-date and organized
- Rename and Move a TemplateLearn how to rename a template and move it to a different template category in QuoteCloud to keep your template library organized.