Docs
Dashboard Get an API key

MCP tool

get_template

One template with its fields, so the assistant knows how many signers it needs and what each fills in.

Read-onlyIdempotent

What the model sees

The tool's own description, which is how the assistant decides when to use it:

One template with every field its glyphs define: which signer (1-based), type (signature, initials, name, date, text, checkbox), page and label.

Arguments

uidstringrequired
The template's uid (8 characters).

Returns

The template object, with fields. It comes back as a single text content item holding this JSON.

uidstring
The template's id: 8 letters and digits.
namestring
Your name for it (150 characters at most). Defaults to the file name.
source_namestring
The uploaded file's name.
source_typestring
What was uploaded. Word documents are converted to PDF on upload.
One of pdf docx
page_countinteger
Pages in the document.
signer_countinteger
Signers the glyphs call for: the highest glyph number.
field_countinteger
Fields found in the document.
date_createdstring (date-time)
When it was uploaded.
date_updatedstring (date-time)
When it last changed.
fieldsarray of objects
Every field, from its glyphs or placed by hand, in page order.
Single-template responses only.
ShowHide field attributes
idinteger | null
The field's id on a pact. null on a template.
recipientinteger
The signer the field belongs to: the number in its glyph (\s2\ → 2), or the signer it was given to in the website's field editor.
typestring
What the signer provides.
One of signature initials name date text checkbox
pageinteger
The page it is on, starting at 1.
xnumber
Distance from the page's left edge, in PDF points (1/72 inch).
ynumber
Distance from the top of the page to the box's bottom edge, in points: the glyph's text baseline. Signatures stand on that line.
widthnumber
The box's width in points: set by the field type for a glyph, as drawn for a field placed by hand on the website.
heightnumber
The box's height in points: set by the field type for a glyph, as drawn for a field placed by hand on the website.
labelstring | null
The label from the glyph, such as Company in \t1:Company\, or the one typed in the field editor.
requiredboolean
false when the glyph ends in ! (\t1:Phone!\, \c1!\), or when the field was made optional in the field editor.
valuestring | null
What was filled in, once that signer has signed: text as typed, "1" or "0" for a checkbox, the typed name for name, and the signing date (MM/dd/yyyy, UTC) for date. Signatures and initials are images on the PDF, so they stay null.

Errors

A failure comes back as a tool result with isError: true whose text is An error occurred invoking 'get_template': followed by the message, so the assistant can read it and tell you. The messages include:

  • No template '{uid}'.

REST equivalent

GETGet a template