Tool documentation

Reference for every Model Context Protocol (MCP) tool exposed at /mcp, with example prompts an agent (or a human) can use to invoke it. ← Back to home

BrandingTools · CreateBranding

destructiveopen-world

Create a branding in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
templates string yes Required JSON object of HTML email templates keyed by template name, e.g. {"signatures_request":"<html>...</html>"}. Signaturit requires this parameter, but you only need to include the template name(s) relevant to what you're customizing — not all of them. Valid names: signatures_request (sent when a document is sent to sign; must contain the {{sign_button}} magic word), pending_sign (reminder for a pending document; must contain {{sign_button}}), validation_request (sent to a validator; must contain {{validate_button}}), emails_request (certified email send; must contain {{email_button}}), signatures_receipt (copy of the signed document), request_expired (sent to the signer when a document expires), request_expired_requester (sent to the requester when a document expires), document_canceled (sent when the requester cancels), signed_document (sent to the requester once completed), document_declined (sent to the requester when a signer declines; may use {{reason}} and {{dashboard_button}}). Other magic words usable in any of the above (unless noted as restricted to a specific one): {{sender_email}}, {{signer_name}}, {{signer_email}}, {{filename}}, {{logo}}; {{remaining_time}} is restricted to pending_sign; {{email_body}} is restricted to signatures_request; {{signers}} is restricted to signed_document. Using a magic word in a template it isn't listed for causes a 400 error ("The following word cannot be used on template") — never add {{sign_button}}, {{validate_button}}, or {{email_button}} outside the one template each is tied to above. To set a subject, add an HTML <title> tag to that template's content.
smsTemplates string no Optional JSON object of SMS templates keyed by template name, e.g. {"sms_verify":"...{{code}}..."}. Omit this parameter entirely if the user doesn't need SMS — do not ask them for one, and do not invent a placeholder yourself; just call the tool without it. (Signaturit's own API documentation lists this as required, but this tool sends the request without it when you omit it and lets the live API response be the source of truth — if Signaturit's API actually rejects the request for missing it, the error returned will say so, and only then does it need a value.) Valid template names if you do provide one: sms_verify (SMS code sent as a password to open a document) and sms_validate (SMS code sent to validate signing) — only one is needed. Both must contain the {{code}} magic word, the only one valid here.
textColor string yes Required primary text color.
layoutColor string no Optional primary element color.
logo string no Optional logo to send in emails, base64-encoded.
signatureColor string no Optional color for the signature draw widget: black or blue.
showCsv bool? no Optional flag to show the CSV stamp on the signed file.
showBiometricHash bool? no Optional flag to show the biometric hash on the signed document.
showWelcomePage bool? no Optional flag to show the welcome page before the document.
headerColor string no Optional sign-app header color.
footerColor string no Optional sign-app footer color.
name string no Optional name for the branding (max 24 characters).
csvPosition string no Optional CSV stamp position: left or right.

Example prompts

← Back to home

BrandingTools · GetBranding

read-onlyopen-world

Get a single branding from your Signaturit account by its id.

Parameters

ParameterTypeRequiredDescription
brandingId string yes The id of the branding to fetch.

Example prompts

← Back to home

BrandingTools · GetBrandings

read-onlyopen-world

Get the brandings in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of brandings to return (max 10, default 10).
offset int? no Pagination offset (default 0).
since string no Return brandings created at or after this date (format YYYY-MM-DD).
until string no Return brandings created before this date (format YYYY-MM-DD).

Example prompts

← Back to home

BrandingTools · UpdateBranding

destructiveidempotentopen-world

Update a branding in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
brandingId string yes The id of the branding to update.
templates string yes Required JSON object of HTML email templates keyed by template name, e.g. {"signatures_request":"<html>...</html>"}. Signaturit requires this parameter, but you only need to include the template name(s) relevant to what you're customizing — not all of them. Valid names: signatures_request (sent when a document is sent to sign; must contain the {{sign_button}} magic word), pending_sign (reminder for a pending document; must contain {{sign_button}}), validation_request (sent to a validator; must contain {{validate_button}}), emails_request (certified email send; must contain {{email_button}}), signatures_receipt (copy of the signed document), request_expired (sent to the signer when a document expires), request_expired_requester (sent to the requester when a document expires), document_canceled (sent when the requester cancels), signed_document (sent to the requester once completed), document_declined (sent to the requester when a signer declines; may use {{reason}} and {{dashboard_button}}). Other magic words usable in any of the above (unless noted as restricted to a specific one): {{sender_email}}, {{signer_name}}, {{signer_email}}, {{filename}}, {{logo}}; {{remaining_time}} is restricted to pending_sign; {{email_body}} is restricted to signatures_request; {{signers}} is restricted to signed_document. Using a magic word in a template it isn't listed for causes a 400 error ("The following word cannot be used on template") — never add {{sign_button}}, {{validate_button}}, or {{email_button}} outside the one template each is tied to above. To set a subject, add an HTML <title> tag to that template's content.
smsTemplates string no Optional JSON object of SMS templates keyed by template name, e.g. {"sms_verify":"...{{code}}..."}. Omit this parameter entirely if the user doesn't need SMS — do not ask them for one, and do not invent a placeholder yourself; just call the tool without it. (Signaturit's own API documentation lists this as required, but this tool sends the request without it when you omit it and lets the live API response be the source of truth — if Signaturit's API actually rejects the request for missing it, the error returned will say so, and only then does it need a value.) Valid template names if you do provide one: sms_verify (SMS code sent as a password to open a document) and sms_validate (SMS code sent to validate signing) — only one is needed. Both must contain the {{code}} magic word, the only one valid here.
textColor string yes Required primary text color.
layoutColor string no Optional primary element color.
logo string no Optional logo to send in emails, base64-encoded.
signatureColor string no Optional color for the signature draw widget: black or blue.
showCsv bool? no Optional flag to show the CSV stamp on the signed file.
showBiometricHash bool? no Optional flag to show the biometric hash on the signed document.
showWelcomePage bool? no Optional flag to show the welcome page before the document.
headerColor string no Optional sign-app header color.
footerColor string no Optional sign-app footer color.
name string no Optional name for the branding (max 24 characters).
csvPosition string no Optional CSV stamp position: left or right.

Example prompts

← Back to home

ContactsTools · CreateContact

destructiveopen-world

Create a contact in your Signaturit address book.

Parameters

ParameterTypeRequiredDescription
email string yes The contact's email address.
name string yes The contact's name.

Example prompts

← Back to home

ContactsTools · DeleteContact

destructiveidempotentopen-world

Delete a contact from your Signaturit address book.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the contact to delete.

Example prompts

← Back to home

ContactsTools · GetContact

read-onlyopen-world

Get a single contact from your Signaturit address book by its id.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the contact to fetch.

Example prompts

← Back to home

ContactsTools · GetContacts

read-onlyopen-world

Get the list of contacts in your Signaturit address book.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of contacts to return (default 100).
offset int? no Pagination offset (default 0).
email string no Filter contacts by email address.
name string no Filter contacts by name.

Example prompts

← Back to home

ContactsTools · UpdateContact

destructiveidempotentopen-world

Update a contact in your Signaturit address book.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the contact to update.
email string yes The contact's new email address.
name string yes The contact's new name.

Example prompts

← Back to home

CreditsTools · GetCredits

read-onlyopen-world

Get the number of remaining credits in your account.

Parameters

No parameters.

Example prompts

← Back to home

EmailsTools · CountEmails

read-onlyopen-world

Count certified emails in your Signaturit account, optionally filtered by status or date.

Parameters

ParameterTypeRequiredDescription
status string no Filter by status (in_queue, sent, error).
since string no Count certified emails sent at or after this date (format YYYY-MM-DD).

Example prompts

← Back to home

EmailsTools · CreateEmail

destructiveopen-world

Send a certified email.

Parameters

ParameterTypeRequiredDescription
recipients string yes A JSON array of recipients, each with name and email, e.g. [{"name":"Jane","email":"jane@x.com"}].
subject string no Optional email subject.
body string no Optional email body (HTML allowed).
brandingId string no Optional custom branding id.
data string no Optional JSON object of custom key/value data to store, e.g. {"crm_id":"123"}.
eventsUrl string no Optional URL to receive realtime lifecycle events (e.g. document_opened, certification_completed) for this certified email.

Example prompts

← Back to home

EmailsTools · GetEmail

read-onlyopen-world

Get a single certified email from your Signaturit account by its id.

Parameters

ParameterTypeRequiredDescription
id string yes The unique identifier of the certified email to fetch.

Example prompts

← Back to home

EmailsTools · GetEmails

read-onlyopen-world

Get certified emails in your Signaturit account, optionally filtered by status or date.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of certified emails to return (max 100, default 100).
offset int? no Pagination offset (default 0).
status string no Filter by status (in_queue, sent, error).
since string no Return certified emails sent at or after this date (format YYYY-MM-DD).

Example prompts

← Back to home

HelpTools · GetMcpFaq

read-onlylocal

Get an FAQ about what this MCP server can and cannot do (file uploads, recipient types, event data, and other known limitations).

Parameters

No parameters.

Example prompts

← Back to home

SignatureTools · CancelSignature

destructiveidempotentopen-world

Cancel a signature request so the signer can no longer sign it.

Parameters

ParameterTypeRequiredDescription
signatureId string yes The id of the signature request to cancel.
reason string no Optional reason for the cancellation.

Example prompts

← Back to home

SignatureTools · ChangeSignerEmail

destructiveopen-world

Change the email of a signer whose document had an email delivery error.

Parameters

ParameterTypeRequiredDescription
signatureId string yes The id of the signature request.
documentId string yes The id of the document whose signer email to change.
email string yes The signer's new email address.
name string no Optional new signer name; the previous name is kept when omitted.

Example prompts

← Back to home

SignatureTools · CountSignatures

read-onlyopen-world

Count signature requests in your Signaturit account, optionally filtered by status or date range.

Parameters

ParameterTypeRequiredDescription
status string no Filter by document status (e.g. completed, in_queue, signing, expired, canceled, declined, error).
since string no Count signatures sent at or after this date (format YYYY-MM-DD).
until string no Count signatures sent before this date (format YYYY-MM-DD).
ids string no Limit the count to a comma-separated list of signature ids.

Example prompts

← Back to home

SignatureTools · CreateSignatureFromTemplate

destructiveopen-world

Create and send a signature request using an existing Signaturit template.

Parameters

ParameterTypeRequiredDescription
templateId string yes The id or hashtag of the Signaturit template to send.
type string yes The signature type: 'simple' or 'advanced'. Must match the template's inferred type as reported by GetTemplates — never omit this or guess.
recipients string yes A JSON array of signers, each with name and email, plus optional fields: phone (required for sms method/validation), method ('email' or 'sms', overrides deliveryType for this signer), type ('signer', 'validator', or 'qualified' — 'qualified' only works if the template supports it), require_sms_validation (bool, needs phone), sms_code (bool, needs phone). E.g. [{"name":"Jane","email":"jane@x.com","method":"email"}].
subject string no Optional email subject for the signature request.
body string no Optional email body (HTML allowed) for the signature request.
deliveryType string no Optional delivery type: email, sms, or url. Defaults to email. Can be overridden per signer via the recipient's method field.
cc string no Optional JSON array of carbon-copy recipients, each with name and email, e.g. [{"name":"Bob","email":"bob@x.com"}].
reminders string no Optional comma-separated reminder schedule in days, e.g. "3,7".
expireTime int? no Optional expiration time of the request in days (1-365).
data string no Optional JSON object of template field values to prefill, e.g. {"crm_id":"123"}.
eventsUrl string no Optional URL to receive realtime lifecycle events (e.g. document_signed, document_completed) for this signature request.

Example prompts

← Back to home

SignatureTools · DeleteSignature

destructiveidempotentopen-world

Delete a signature request (in-progress requests cannot be deleted).

Parameters

ParameterTypeRequiredDescription
signatureId string yes The id of the signature request to delete.

Example prompts

← Back to home

SignatureTools · GetSignature

read-onlyopen-world

Get a single signature request from your Signaturit account by its id.

Parameters

ParameterTypeRequiredDescription
signatureId string yes The unique identifier of the signature request to fetch.

Example prompts

← Back to home

SignatureTools · GetSignatures

read-onlyopen-world

Get signature requests in your Signaturit account, optionally filtered by status or date range.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of signatures to return (max 100, default 100).
offset int? no Pagination offset (default 0; limit + offset cannot exceed 10000).
status string no Filter by document status (e.g. completed, in_queue, ready, signing, expired, canceled, declined, error).
since string no Return signatures sent at or after this date (format YYYY-MM-DD).
until string no Return signatures sent before this date (format YYYY-MM-DD).
ids string no Limit the result set to a comma-separated list of signature ids.

Example prompts

← Back to home

SignatureTools · SendReminder

destructiveopen-world

Send a reminder to the pending signer of a signature request.

Parameters

ParameterTypeRequiredDescription
signatureId string yes The id of the signature request to remind.

Example prompts

← Back to home

SmsTools · CountSms

read-onlyopen-world

Count certified SMS in your Signaturit account, optionally filtered by status or date.

Parameters

ParameterTypeRequiredDescription
status string no Filter by status (in_queue, sent, error).
since string no Count certified SMS sent at or after this date (format YYYY-MM-DD).

Example prompts

← Back to home

SmsTools · CreateSms

destructiveopen-world

Send a certified SMS.

Parameters

ParameterTypeRequiredDescription
recipients string yes A JSON array of recipients, each with name and phone (with country prefix), e.g. [{"name":"Jane","phone":"34600111222"}].
body string yes The SMS body (maximum 120 characters).
brandingId string no Optional custom branding id.
eventsUrl string no Optional URL to receive realtime lifecycle events (e.g. document_opened, certification_completed) for this certified SMS.

Example prompts

← Back to home

SmsTools · GetSms

read-onlyopen-world

Get a single certified SMS from your Signaturit account by its id.

Parameters

ParameterTypeRequiredDescription
id string yes The unique identifier of the certified SMS to fetch.

Example prompts

← Back to home

SmsTools · GetSmsMessages

read-onlyopen-world

Get certified SMS in your Signaturit account, optionally filtered by status or date.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of certified SMS to return (max 100, default 100).
offset int? no Pagination offset (default 0).
status string no Filter by status (in_queue, sent, error).
since string no Return certified SMS sent at or after this date (format YYYY-MM-DD).

Example prompts

← Back to home

SubscriptionsTools · CreateSubscription

destructiveopen-world

Create an event webhook subscription in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
url string yes The URL that will receive the subscribed event information.
events string yes A comma-separated list of events to subscribe to, or "*" for all events. Supported event names: email_processed, email_delivered, email_bounced, email_deferred, reminder_email_processed, reminder_email_delivered, sms_processed, sms_delivered, document_opened, document_signed, document_completed, audit_trail_completed, document_declined, document_expired, document_canceled, photo_added, voice_added, file_added, photo_id_added, expiration_extended. E.g. "document_signed,document_completed".

Example prompts

← Back to home

SubscriptionsTools · DeleteSubscription

destructiveidempotentopen-world

Delete an event webhook subscription from your Signaturit account.

Parameters

ParameterTypeRequiredDescription
subscriptionId string yes The id of the subscription to delete.

Example prompts

← Back to home

SubscriptionsTools · GetSubscription

read-onlyopen-world

Get a single event webhook subscription from your Signaturit account by its id.

Parameters

ParameterTypeRequiredDescription
subscriptionId string yes The id of the subscription to fetch.

Example prompts

← Back to home

SubscriptionsTools · GetSubscriptions

read-onlyopen-world

Get the event webhook subscriptions in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of subscriptions to return (max 100, default 100).
offset int? no Pagination offset (default 0).
eventFilter string no Optional filter to subscriptions attached to this event.

Example prompts

← Back to home

SubscriptionsTools · UpdateSubscription

destructiveidempotentopen-world

Update an event webhook subscription in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
subscriptionId string yes The id of the subscription to update.
url string yes The new URL that will receive the subscribed event information.
events string yes A comma-separated list of events to subscribe to, or "*" for all events. Supported event names: email_processed, email_delivered, email_bounced, email_deferred, reminder_email_processed, reminder_email_delivered, sms_processed, sms_delivered, document_opened, document_signed, document_completed, audit_trail_completed, document_declined, document_expired, document_canceled, photo_added, voice_added, file_added, photo_id_added, expiration_extended. E.g. "document_signed,document_completed".

Example prompts

← Back to home

TeamTools · AddTeamGroupManager

destructiveidempotentopen-world

Add a seat to a Signaturit team group as manager.

Parameters

ParameterTypeRequiredDescription
groupId string yes The id of the group.
seatId string yes The id of the seat to add as manager — from GetTeamSeats, not GetTeamUsers (they use different id spaces for the same person).

Example prompts

← Back to home

TeamTools · AddTeamGroupMember

destructiveidempotentopen-world

Add a seat to a Signaturit team group as member.

Parameters

ParameterTypeRequiredDescription
groupId string yes The id of the group.
seatId string yes The id of the seat to add as member — from GetTeamSeats, not GetTeamUsers (they use different id spaces for the same person).

Example prompts

← Back to home

TeamTools · CreateTeamGroup

destructiveopen-world

Create a group on your Signaturit team.

Parameters

ParameterTypeRequiredDescription
name string yes The name of the group.

Example prompts

← Back to home

TeamTools · DeleteTeamGroup

destructiveidempotentopen-world

Delete a group from your Signaturit team.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the group to delete.

Example prompts

← Back to home

TeamTools · DeleteTeamSeat

destructiveidempotentopen-world

Remove a seat from your Signaturit team.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the seat to remove.

Example prompts

← Back to home

TeamTools · DeleteTeamUser

destructiveidempotentopen-world

Remove a user from your Signaturit team.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the user to remove.

Example prompts

← Back to home

TeamTools · GetTeamGroup

read-onlyopen-world

Get a single group from your Signaturit team by id.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the group to fetch.

Example prompts

← Back to home

TeamTools · GetTeamGroups

read-onlyopen-world

Get the groups on your Signaturit team.

Parameters

No parameters.

Example prompts

← Back to home

TeamTools · GetTeamSeats

read-onlyopen-world

Get the seats on your Signaturit team.

Parameters

No parameters.

Example prompts

← Back to home

TeamTools · GetTeamUser

read-onlyopen-world

Get a single user from your Signaturit team by id.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the user to fetch.

Example prompts

← Back to home

TeamTools · GetTeamUsers

read-onlyopen-world

Get the users on your Signaturit team.

Parameters

No parameters.

Example prompts

← Back to home

TeamTools · InviteTeamUser

destructiveopen-world

Invite a user to your Signaturit team.

Parameters

ParameterTypeRequiredDescription
email string yes The email of the user to invite.
role string yes The role to assign: admin or member.

Example prompts

← Back to home

TeamTools · RemoveTeamGroupManager

destructiveidempotentopen-world

Remove a manager from a Signaturit team group.

Parameters

ParameterTypeRequiredDescription
groupId string yes The id of the group.
seatId string yes The id of the manager seat to remove — from GetTeamSeats, not GetTeamUsers (they use different id spaces for the same person).

Example prompts

← Back to home

TeamTools · RemoveTeamGroupMember

destructiveidempotentopen-world

Remove a member from a Signaturit team group.

Parameters

ParameterTypeRequiredDescription
groupId string yes The id of the group.
seatId string yes The id of the member seat to remove — from GetTeamSeats, not GetTeamUsers (they use different id spaces for the same person).

Example prompts

← Back to home

TeamTools · UpdateTeamGroup

destructiveidempotentopen-world

Update a group on your Signaturit team.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the group to update.
name string yes The new name of the group.

Example prompts

← Back to home

TeamTools · UpdateTeamUserRole

destructiveidempotentopen-world

Update a Signaturit team user's role.

Parameters

ParameterTypeRequiredDescription
id string yes The id of the user to update.
role string yes The new role: admin or member.

Example prompts

← Back to home

TemplatesTools · GetTemplates

read-onlyopen-world

List the templates in your Signaturit account.

Parameters

ParameterTypeRequiredDescription
limit int? no Maximum number of templates to return (max 10, default 10).
page int? no Results page, 1-based (default 1).

Example prompts

← Back to home