Create a draft document
create_draftSave markdown as a draft document. Recipients are detected from the signature fields. Drafts are free and can be updated any number of times. Set send=true to send immediately (uses one envelope). Returns preview_url, a 7-day link to show your human the document and compare styles.
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": {
"markdown": "<markdown>"
},
"name": "create_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| send | No | Send for signature immediately after saving. | |
| style | No | Visual style; defaults to the markdown directive or classic. | |
| title | No | Optional title; defaults to the first "# Heading". | |
| api_key | No | An md2sign API key. When given, this call uses that key's account even if the connection is signed in as someone else, so pass it on every call when your human has more than one md2sign account (for example two businesses). Also use it if your MCP client cannot send an "Authorization: Bearer <api_key>" header. | |
| message | No | Short personal note from the sender, included in the email. | |
| markdown | Yes | The full markdown contract with [[signature: First Last <email>]] fields. | |
| metadata | No | Your own key/value details for this document, e.g. {"customer_number": "C-1001", "job_number": "J-77", "quote_number": "Q-310"}. Flat object, up to 20 keys (starting with a letter or _, then letters, numbers, _ or -), text or number values up to 500 characters, stored as text. Returned in responses and webhooks; find documents by it with list_documents metadata. | |
| sender_role | No | Optional role shown on the sender's signature, e.g. "Client" or "Director". Used with sender_signs=true. | |
| sender_signs | No | true adds a signature field for the sender (the account holder, using their name and email); false removes it. Only for two-sided agreements (services/contractor agreements, mutual NDAs, leases, partnerships). Never for quotes, proposals, consents, acknowledgements, waivers or one-way NDAs, where only the recipient signs. Check validation.signing_advice and ask the human if unsure. | |
| verify_signers | No | Team plans: true makes every signer confirm a one-time code emailed to them before their signature is recorded (adds <!-- md2sign:verify=email -->); false turns it off for this document even when the account verifies signers by default (verify=none). Omit to use the account default. | |
| external_reference | No | Your own ID for this document. |