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 · CreateBrandingdestructiveopen-world
Create a branding in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
BrandingTools · GetBrandingread-onlyopen-world
Get a single branding from your Signaturit account by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
brandingId |
string |
yes | The id of the branding to fetch. |
BrandingTools · GetBrandingsread-onlyopen-world
Get the brandings in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
BrandingTools · UpdateBrandingdestructiveidempotentopen-world
Update a branding in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
ContactsTools · CreateContactdestructiveopen-world
Create a contact in your Signaturit address book.
| Parameter | Type | Required | Description |
|---|---|---|---|
email |
string |
yes | The contact's email address. |
name |
string |
yes | The contact's name. |
ContactsTools · DeleteContactdestructiveidempotentopen-world
Delete a contact from your Signaturit address book.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the contact to delete. |
ContactsTools · GetContactread-onlyopen-world
Get a single contact from your Signaturit address book by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the contact to fetch. |
ContactsTools · GetContactsread-onlyopen-world
Get the list of contacts in your Signaturit address book.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
ContactsTools · UpdateContactdestructiveidempotentopen-world
Update a contact in your Signaturit address book.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
CreditsTools · GetCreditsread-onlyopen-world
Get the number of remaining credits in your account.
No parameters.
EmailsTools · CountEmailsread-onlyopen-world
Count certified emails in your Signaturit account, optionally filtered by status or date.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
EmailsTools · CreateEmaildestructiveopen-world
Send a certified email.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
EmailsTools · GetEmailread-onlyopen-world
Get a single certified email from your Signaturit account by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The unique identifier of the certified email to fetch. |
EmailsTools · GetEmailsread-onlyopen-world
Get certified emails in your Signaturit account, optionally filtered by status or date.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
HelpTools · GetMcpFaqread-onlylocal
Get an FAQ about what this MCP server can and cannot do (file uploads, recipient types, event data, and other known limitations).
No parameters.
SignatureTools · CancelSignaturedestructiveidempotentopen-world
Cancel a signature request so the signer can no longer sign it.
| Parameter | Type | Required | Description |
|---|---|---|---|
signatureId |
string |
yes | The id of the signature request to cancel. |
reason |
string |
no | Optional reason for the cancellation. |
SignatureTools · ChangeSignerEmaildestructiveopen-world
Change the email of a signer whose document had an email delivery error.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SignatureTools · CountSignaturesread-onlyopen-world
Count signature requests in your Signaturit account, optionally filtered by status or date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SignatureTools · CreateSignatureFromTemplatedestructiveopen-world
Create and send a signature request using an existing Signaturit template.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SignatureTools · DeleteSignaturedestructiveidempotentopen-world
Delete a signature request (in-progress requests cannot be deleted).
| Parameter | Type | Required | Description |
|---|---|---|---|
signatureId |
string |
yes | The id of the signature request to delete. |
SignatureTools · GetSignatureread-onlyopen-world
Get a single signature request from your Signaturit account by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
signatureId |
string |
yes | The unique identifier of the signature request to fetch. |
SignatureTools · GetSignaturesread-onlyopen-world
Get signature requests in your Signaturit account, optionally filtered by status or date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SignatureTools · SendReminderdestructiveopen-world
Send a reminder to the pending signer of a signature request.
| Parameter | Type | Required | Description |
|---|---|---|---|
signatureId |
string |
yes | The id of the signature request to remind. |
SmsTools · CountSmsread-onlyopen-world
Count certified SMS in your Signaturit account, optionally filtered by status or date.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
SmsTools · CreateSmsdestructiveopen-world
Send a certified SMS.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SmsTools · GetSmsread-onlyopen-world
Get a single certified SMS from your Signaturit account by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The unique identifier of the certified SMS to fetch. |
SmsTools · GetSmsMessagesread-onlyopen-world
Get certified SMS in your Signaturit account, optionally filtered by status or date.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
SubscriptionsTools · CreateSubscriptiondestructiveopen-world
Create an event webhook subscription in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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". |
SubscriptionsTools · DeleteSubscriptiondestructiveidempotentopen-world
Delete an event webhook subscription from your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
subscriptionId |
string |
yes | The id of the subscription to delete. |
SubscriptionsTools · GetSubscriptionread-onlyopen-world
Get a single event webhook subscription from your Signaturit account by its id.
| Parameter | Type | Required | Description |
|---|---|---|---|
subscriptionId |
string |
yes | The id of the subscription to fetch. |
SubscriptionsTools · GetSubscriptionsread-onlyopen-world
Get the event webhook subscriptions in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
SubscriptionsTools · UpdateSubscriptiondestructiveidempotentopen-world
Update an event webhook subscription in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
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". |
TeamTools · AddTeamGroupManagerdestructiveidempotentopen-world
Add a seat to a Signaturit team group as manager.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
TeamTools · AddTeamGroupMemberdestructiveidempotentopen-world
Add a seat to a Signaturit team group as member.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
TeamTools · CreateTeamGroupdestructiveopen-world
Create a group on your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string |
yes | The name of the group. |
TeamTools · DeleteTeamGroupdestructiveidempotentopen-world
Delete a group from your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the group to delete. |
TeamTools · DeleteTeamSeatdestructiveidempotentopen-world
Remove a seat from your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the seat to remove. |
TeamTools · DeleteTeamUserdestructiveidempotentopen-world
Remove a user from your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the user to remove. |
TeamTools · GetTeamGroupread-onlyopen-world
Get a single group from your Signaturit team by id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the group to fetch. |
TeamTools · GetTeamGroupsread-onlyopen-world
Get the groups on your Signaturit team.
No parameters.
TeamTools · GetTeamSeatsread-onlyopen-world
Get the seats on your Signaturit team.
No parameters.
TeamTools · GetTeamUserread-onlyopen-world
Get a single user from your Signaturit team by id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the user to fetch. |
TeamTools · GetTeamUsersread-onlyopen-world
Get the users on your Signaturit team.
No parameters.
TeamTools · InviteTeamUserdestructiveopen-world
Invite a user to your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
email |
string |
yes | The email of the user to invite. |
role |
string |
yes | The role to assign: admin or member. |
TeamTools · RemoveTeamGroupManagerdestructiveidempotentopen-world
Remove a manager from a Signaturit team group.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
TeamTools · RemoveTeamGroupMemberdestructiveidempotentopen-world
Remove a member from a Signaturit team group.
| Parameter | Type | Required | Description |
|---|---|---|---|
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). |
TeamTools · UpdateTeamGroupdestructiveidempotentopen-world
Update a group on your Signaturit team.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the group to update. |
name |
string |
yes | The new name of the group. |
TeamTools · UpdateTeamUserRoledestructiveidempotentopen-world
Update a Signaturit team user's role.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string |
yes | The id of the user to update. |
role |
string |
yes | The new role: admin or member. |
TemplatesTools · GetTemplatesread-onlyopen-world
List the templates in your Signaturit account.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit |
int? |
no | Maximum number of templates to return (max 10, default 10). |
page |
int? |
no | Results page, 1-based (default 1). |