Skip to main content
Glama

Assinafy MCP Server

Send a template for signature

assinafy_create_document_from_template

Generate a document from a saved template and invite each Signer role, with optional CopyReceiver roles, by signer ID or full name and email. Editor roles use only editor_fields. Find roles with assinafy_list_templates and validate editor_fields values with assinafy_validate_fields first. DigitalCertificate signers require a template without placed signer fields. This sends invitations and can consume credits. Verification settings select a method only. This tool does not accept biometric data; never request or submit it in chat or tool arguments. Any biometric verification occurs directly between the signer and Assinafy on its signing page, with the signer's consent.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "template_id": "<template_id>",
      "signers": "<signers>"
    },
    "name": "assinafy_create_document_from_template"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNocustom document name
tagsNotag names, merged with the template's defaults
messageNosigning invitation message
signersYesone entry per Signer role and optional CopyReceiver roles; Editor roles use editor_fields
account_idNoaccount ID; uses request routing if omitted
expires_atNoassignment expiry as an ISO 8601 date or date-time
template_idYestemplate ID
editor_fieldsNotemplate editor field values
estimate_onlyNopreview cost and balances for the given roles without creating contacts, documents or invitations; roles alone are sufficient
max_total_creditsNomaximum credits allowed for sending; use total_credits from the latest estimate

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / signers / items / properties / verification_method / description
      Previous value: -"Email (default), Whatsapp, DigitalCertificate (A1/A3, templates without placed signer fields only), or IdDocumentFaceMatchBasic (the signer completes ID photo and liveness checks on Assinafy's signing page; this tool never receives those images or face data)"New value: +"Verification method name only: Email (default), Whatsapp, DigitalCertificate (A1/A3, templates without placed signer fields only), or IdDocumentFaceMatchBasic (biometric verification performed by the signer directly on Assinafy's signing page, with consent there). No identity evidence is accepted; do not ask for or submit biometric data in chat or tool arguments"
  2. Changed1 schema field changed
    • changedInput schema / properties / signers / items / properties / verification_method / description
      Previous value: -"Email (default), Whatsapp, DigitalCertificate (A1/A3, templates without placed signer fields only), or IdDocumentFaceMatchBasic (ID photo and liveness)"New value: +"Email (default), Whatsapp, DigitalCertificate (A1/A3, templates without placed signer fields only), or IdDocumentFaceMatchBasic (the signer completes ID photo and liveness checks on Assinafy's signing page; this tool never receives those images or face data)"
  3. Changed5 schema fields changed
    • changedInput schema / properties / expires_at / description
      Previous value: -"assignment expiry in RFC 3339 format"New value: +"assignment expiry as an ISO 8601 date or date-time"
    • addedInput schema / properties / max_total_credits
      Added value: +{
      +  "description": "maximum credits allowed for sending; use total_credits from the latest estimate",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • changedInput schema / properties / signers / description
      Previous value: -"one signer per template role, each by ID or by name and email"New value: +"one entry per Signer role and optional CopyReceiver roles; Editor roles use editor_fields"
    • changedInput schema / properties / signers / items / properties / step / description
      Previous value: -"signing order, contiguous from 1; all signers must set it if any does"New value: +"signing order, contiguous from 1; all Signer roles must set it if any does; CopyReceiver roles ignore it"
    • changedInput schema / properties / signers / items / properties / verification_method / description
      Previous value: -"Email (default), Whatsapp, DigitalCertificate (A1/A3, virtual templates without placed fields only), or IdDocumentFaceMatchBasic (ID photo and liveness)"New value: +"Email (default), Whatsapp, DigitalCertificate (A1/A3, templates without placed signer fields only), or IdDocumentFaceMatchBasic (ID photo and liveness)"
  4. Changed1 schema field changed
    • changedInput schema / properties / signers / items / properties / verification_method / description
      Previous value: -"Email (default), Whatsapp, DigitalCertificate (A1/A3), or IdDocumentFaceMatchBasic (ID photo and liveness)"New value: +"Email (default), Whatsapp, DigitalCertificate (A1/A3, virtual templates without placed fields only), or IdDocumentFaceMatchBasic (ID photo and liveness)"
  5. Changed2 schema fields changed
    • addedInput schema / properties / estimate_only
      Added value: +{
      +  "description": "preview cost and balances for the given roles without creating contacts, documents or invitations; roles alone are sufficient",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / signers / items / properties / verification_method / description
      Previous value: -"Email (default), Whatsapp, or DigitalCertificate"New value: +"Email (default), Whatsapp, DigitalCertificate (A1/A3), or IdDocumentFaceMatchBasic (ID photo and liveness)"
  6. Added
  7. Removed
  8. Changed10 schema fields changed
    • changedInput schema / properties / signers / description
      Previous value: -"one email signer per template role"New value: +"one signer per template role, each by ID or by name and email"
    • changedInput schema / properties / signers / items / properties / email / description
      Previous value: -"signer's email address; existing exact matches are reused"New value: +"signer's email address, required when id is omitted; existing exact matches are reused"
    • changedInput schema / properties / signers / items / properties / full_name / description
      Previous value: -"signer's full name"New value: +"signer's full name; required when id is omitted"
    • addedInput schema / properties / signers / items / properties / id
      Added value: +{
      +  "description": "existing signer ID; use instead of full_name and email",
      +  "type": "string"
      +}
    • addedInput schema / properties / signers / items / properties / notification_methods
      Added value: +{
      +  "description": "delivery channels; inferred from verification_method when omitted",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": [
      +    "null",
      +    "array"
      +  ]
      +}
    • addedInput schema / properties / signers / items / properties / step
      Added value: +{
      +  "description": "signing order, contiguous from 1; all signers must set it if any does",
      +  "type": [
      +    "null",
      +    "integer"
      +  ]
      +}
    • addedInput schema / properties / signers / items / properties / verification_method
      Added value: +{
      +  "description": "Email (default), Whatsapp, or DigitalCertificate",
      +  "type": "string"
      +}
    • changedInput schema / properties / signers / items / required
      Previous value: -[
      -  "role_id",
      -  "full_name",
      -  "email"
      -]New value: +[
      +  "role_id"
      +]
    • addedInput schema / properties / tags
      Added value: +{
      +  "description": "tag names, merged with the template's defaults",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": [
      +    "null",
      +    "array"
      +  ]
      +}
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "account_id": {
      -      "type": "string"
      -    },
      -    "activities": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "created_at": {
      -            "type": "string"
      -          },
      -          "event": {
      -            "type": "string"
      -          },
      -          "id": {
      -            "type": "integer"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "origin": true,
      -          "payload": true
      -        },
      -        "required": [
      -          "id",
      -          "event",
      -          "message",
      -          "created_at"
      -        ],
      -        "type": "object"
      -      },
      -      "type": [
      -        "null",
      -        "array"
      -      ]
      -    },
      -    "artifacts": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "bundle": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        },
      -        "certificate-page": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        },
      -        "certificated": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        },
      -        "original": {
      -          "type": "string"
      -        },
      -        "pades": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        },
      -        "thumbnail": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        }
      -      },
      -      "required": [
      -        "original"
      -      ],
      -      "type": [
      -        "null",
      -        "object"
      -      ]
      -    },
      -    "assignment": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "copy_receivers": {
      -          "items": true,
      -          "type": [
      -            "null",
      -            "array"
      -          ]
      -        },
      -        "expiration": {
      -          "type": "string"
      -        },
      -        "expires_at": {
      -          "type": "string"
      -        },
      -        "id": {
      -          "type": "string"
      -        },
      -        "items": {
      -          "items": true,
      -          "type": [
      -            "null",
      -            "array"
      -          ]
      -        },
      -        "message": {
      -          "type": "string"
      -        },
      -        "method": {
      -          "type": "string"
      -        },
      -        "resource": {
      -          "type": "string"
      -        },
      -        "sender_email": {
      -          "type": "string"
      -        },
      -        "signers": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "completed": {
      -                "type": [
      -                  "null",
      -                  "boolean"
      -                ]
      -              },
      -              "email": {
      -                "type": "string"
      -              },
      -              "full_name": {
      -                "type": "string"
      -              },
      -              "has_accepted_terms": {
      -                "type": [
      -                  "null",
      -                  "boolean"
      -                ]
      -              },
      -              "id": {
      -                "type": "string"
      -              },
      -              "notification_history": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "error_code": {
      -                      "type": [
      -                        "null",
      -                        "string"
      -                      ]
      -                    },
      -                    "error_message": {
      -                      "type": [
      -                        "null",
      -                        "string"
      -                      ]
      -                    },
      -                    "event": {
      -                      "type": "string"
      -                    },
      -                    "failed_at": {
      -                      "type": [
      -                        "null",
      -                        "string"
      -                      ]
      -                    },
      -                    "sent_at": {
      -                      "type": [
      -                        "null",
      -                        "string"
      -                      ]
      -                    },
      -                    "status": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "event",
      -                    "status"
      -                  ],
      -                  "type": "object"
      -                },
      -                "type": [
      -                  "null",
      -                  "array"
      -                ]
      -              },
      -              "notification_methods": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": [
      -                  "null",
      -                  "array"
      -                ]
      -              },
      -              "notified": {
      -                "type": [
      -                  "null",
      -                  "boolean"
      -                ]
      -              },
      -              "resource": {
      -                "type": "string"
      -              },
      -              "step": {
      -                "type": [
      -                  "null",
      -                  "integer"
      -                ]
      -              },
      -              "verification_method": {
      -                "type": [
      -                  "null",
      -                  "string"
      -                ]
      -              },
      -              "whatsapp_phone_number": {
      -                "type": [
      -                  "null",
      -                  "string"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "id",
      -              "full_name",
      -              "email"
      -            ],
      -            "type": "object"
      -          },
      -          "type": [
      -            "null",
      -            "array"
      -          ]
      -        },
      -        "signing_urls": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "signer_id": {
      -                "type": "string"
      -              },
      -              "url": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "signer_id",
      -              "url"
      -            ],
      -            "type": "object"
      -          },
      -          "type": [
      -            "null",
      -            "array"
      -          ]
      -        },
      -        "summary": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "completed_count": {
      -              "type": "integer"
      -            },
      -            "signer_count": {
      -              "type": "integer"
      -            },
      -            "signers": {
      -              "items": true,
      -              "type": [
      -                "null",
      -                "array"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "signer_count",
      -            "completed_count"
      -          ],
      -          "type": [
      -            "null",
      -            "object"
      -          ]
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "method"
      -      ],
      -      "type": [
      -        "null",
      -        "object"
      -      ]
      -    },
      -    "created_at": {
      -      "type": "string"
      -    },
      -    "decline_reason": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "declined_by": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "email": {
      -          "type": "string"
      -        },
      -        "full_name": {
      -          "type": "string"
      -        },
      -        "has_accepted_terms": {
      -          "type": [
      -            "null",
      -            "boolean"
      -          ]
      -        },
      -        "id": {
      -          "type": "string"
      -        },
      -        "resource": {
      -          "type": "string"
      -        },
      -        "whatsapp_phone_number": {
      -          "type": [
      -            "null",
      -            "string"
      -          ]
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "full_name",
      -        "email"
      -      ],
      -      "type": [
      -        "null",
      -        "object"
      -      ]
      -    },
      -    "id": {
      -      "type": "string"
      -    },
      -    "is_closed": {
      -      "type": "boolean"
      -    },
      -    "name": {
      -      "type": "string"
      -    },
      -    "pages": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "download_url": {
      -            "type": "string"
      -          },
      -          "height": {
      -            "type": "integer"
      -          },
      -          "id": {
      -            "type": "string"
      -          },
      -          "number": {
      -            "type": "integer"
      -          },
      -          "width": {
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "number",
      -          "height",
      -          "width",
      -          "download_url"
      -        ],
      -        "type": "object"
      -      },
      -      "type": [
      -        "null",
      -        "array"
      -      ]
      -    },
      -    "resource": {
      -      "type": "string"
      -    },
      -    "signing_url": {
      -      "type": "string"
      -    },
      -    "status": {
      -      "type": "string"
      -    },
      -    "tags": {
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "id",
      -          "name"
      -        ],
      -        "type": "object"
      -      },
      -      "type": [
      -        "null",
      -        "array"
      -      ]
      -    },
      -    "template_id": {
      -      "type": [
      -        "null",
      -        "string"
      -      ]
      -    },
      -    "updated_at": {
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "account_id",
      -    "name",
      -    "status",
      -    "is_closed",
      -    "created_at",
      -    "updated_at"
      -  ],
      -  "type": "object"
      -}New value: +null
  9. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "account_id": {
      +      "type": "string"
      +    },
      +    "activities": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "created_at": {
      +            "type": "string"
      +          },
      +          "event": {
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "integer"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "origin": true,
      +          "payload": true
      +        },
      +        "required": [
      +          "id",
      +          "event",
      +          "message",
      +          "created_at"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "artifacts": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "bundle": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        },
      +        "certificate-page": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        },
      +        "certificated": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        },
      +        "original": {
      +          "type": "string"
      +        },
      +        "pades": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        },
      +        "thumbnail": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "original"
      +      ],
      +      "type": [
      +        "null",
      +        "object"
      +      ]
      +    },
      +    "assignment": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "copy_receivers": {
      +          "items": true,
      +          "type": [
      +            "null",
      +            "array"
      +          ]
      +        },
      +        "expiration": {
      +          "type": "string"
      +        },
      +        "expires_at": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "items": {
      +          "items": true,
      +          "type": [
      +            "null",
      +            "array"
      +          ]
      +        },
      +        "message": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "resource": {
      +          "type": "string"
      +        },
      +        "sender_email": {
      +          "type": "string"
      +        },
      +        "signers": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "completed": {
      +                "type": [
      +                  "null",
      +                  "boolean"
      +                ]
      +              },
      +              "email": {
      +                "type": "string"
      +              },
      +              "full_name": {
      +                "type": "string"
      +              },
      +              "has_accepted_terms": {
      +                "type": [
      +                  "null",
      +                  "boolean"
      +                ]
      +              },
      +              "id": {
      +                "type": "string"
      +              },
      +              "notification_history": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "error_code": {
      +                      "type": [
      +                        "null",
      +                        "string"
      +                      ]
      +                    },
      +                    "error_message": {
      +                      "type": [
      +                        "null",
      +                        "string"
      +                      ]
      +                    },
      +                    "event": {
      +                      "type": "string"
      +                    },
      +                    "failed_at": {
      +                      "type": [
      +                        "null",
      +                        "string"
      +                      ]
      +                    },
      +                    "sent_at": {
      +                      "type": [
      +                        "null",
      +                        "string"
      +                      ]
      +                    },
      +                    "status": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "event",
      +                    "status"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": [
      +                  "null",
      +                  "array"
      +                ]
      +              },
      +              "notification_methods": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": [
      +                  "null",
      +                  "array"
      +                ]
      +              },
      +              "notified": {
      +                "type": [
      +                  "null",
      +                  "boolean"
      +                ]
      +              },
      +              "resource": {
      +                "type": "string"
      +              },
      +              "step": {
      +                "type": [
      +                  "null",
      +                  "integer"
      +                ]
      +              },
      +              "verification_method": {
      +                "type": [
      +                  "null",
      +                  "string"
      +                ]
      +              },
      +              "whatsapp_phone_number": {
      +                "type": [
      +                  "null",
      +                  "string"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "full_name",
      +              "email"
      +            ],
      +            "type": "object"
      +          },
      +          "type": [
      +            "null",
      +            "array"
      +          ]
      +        },
      +        "signing_urls": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "signer_id": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "signer_id",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          "type": [
      +            "null",
      +            "array"
      +          ]
      +        },
      +        "summary": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "completed_count": {
      +              "type": "integer"
      +            },
      +            "signer_count": {
      +              "type": "integer"
      +            },
      +            "signers": {
      +              "items": true,
      +              "type": [
      +                "null",
      +                "array"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "signer_count",
      +            "completed_count"
      +          ],
      +          "type": [
      +            "null",
      +            "object"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "method"
      +      ],
      +      "type": [
      +        "null",
      +        "object"
      +      ]
      +    },
      +    "created_at": {
      +      "type": "string"
      +    },
      +    "decline_reason": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "declined_by": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "email": {
      +          "type": "string"
      +        },
      +        "full_name": {
      +          "type": "string"
      +        },
      +        "has_accepted_terms": {
      +          "type": [
      +            "null",
      +            "boolean"
      +          ]
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "resource": {
      +          "type": "string"
      +        },
      +        "whatsapp_phone_number": {
      +          "type": [
      +            "null",
      +            "string"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "full_name",
      +        "email"
      +      ],
      +      "type": [
      +        "null",
      +        "object"
      +      ]
      +    },
      +    "id": {
      +      "type": "string"
      +    },
      +    "is_closed": {
      +      "type": "boolean"
      +    },
      +    "name": {
      +      "type": "string"
      +    },
      +    "pages": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "download_url": {
      +            "type": "string"
      +          },
      +          "height": {
      +            "type": "integer"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "number": {
      +            "type": "integer"
      +          },
      +          "width": {
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "number",
      +          "height",
      +          "width",
      +          "download_url"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "resource": {
      +      "type": "string"
      +    },
      +    "signing_url": {
      +      "type": "string"
      +    },
      +    "status": {
      +      "type": "string"
      +    },
      +    "tags": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "template_id": {
      +      "type": [
      +        "null",
      +        "string"
      +      ]
      +    },
      +    "updated_at": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "id",
      +    "account_id",
      +    "name",
      +    "status",
      +    "is_closed",
      +    "created_at",
      +    "updated_at"
      +  ],
      +  "type": "object"
      +}
  10. First observed

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations by disclosing real side effects: 'This sends invitations and can consume credits', plus the distinction that verification settings only select a method and that any biometric check happens off-tool between signer and Assinafy. These are exactly the consequences an agent needs that readOnlyHint=false and openWorldHint=true do not convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded and each sentence carries operational content. The biometric prohibition is stated twice in near-identical form ('does not accept biometric data; never request or submit it' vs the final sentence), which is redundant wording that could be compressed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter, non-idempotent, credit-consuming mutation with no output schema, the definition covers prerequisites, cost consequences, role-type rules, and the sensitive-data boundary. Nothing an agent must know before invoking it correctly appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds genuine meaning: Editor roles use only editor_fields, DigitalCertificate signers need a field-free template, and verification_method is a method name only. It does not explain estimate_only or max_total_credits behavior, leaving that to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource pair ('Generate a document from a saved template and invite each Signer role') and clarifies the signer/copy-receiver/editor split. It implicitly distinguishes itself from the PDF-based sibling by emphasizing 'from a saved template', though it never names assinafy_send_pdf_for_signature as the alternative.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete prerequisites ('Find roles with assinafy_list_templates and validate editor_fields values with assinafy_validate_fields first') and hard constraints (DigitalCertificate requires a template without placed signer fields; biometric data is out of scope). Lacks explicit when-not-to-use-this-tool routing against the PDF send sibling, which keeps it from a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources