Server definition
- Hash
- sha256:25ac7cfd8e591e654b9b39afb45b497ed55f7240261fa98d5c81f46401bdc1f9
- What it is
- What a remote MCP server returned when asked what it offers: 27 tools
The blob, as servednamed by its sha256
{
"instructions": "md2sign sends markdown contracts for legally binding e-signatures.\n\nMarkdown format: standard markdown plus signature fields, one per signer, each on its own line:\n [[signature: First Last <[email protected]>]]\n [[signature: First Last <[email protected]> | role: Director]]\nOptional hidden directives: <!-- md2sign:style=classic|modern|formal --> and <!-- md2sign:title=... -->.\n\nTeam and Business+ plans: input fields signers fill in, e.g. [[field: Start date | for: [email protected] | type: date | required]] (for: a signer's email or any; type: text, date or checkbox; optional unless | required). Team plans: <!-- md2sign:order=sequential --> makes signers sign one at a time in the order their signature fields appear. Team plans: <!-- md2sign:verify=email --> (or verify_signers: true) makes each signer confirm a one-time code emailed to them before their signature is recorded; accounts can turn this on for every document (get_account shows verify_signers_by_default), and verify=none (verify_signers: false) turns it off for one document.\nDon't add \"date signed\" fields or blank \"Date: ____\" lines next to signatures: every signature already records a tamper-proof UTC timestamp shown on the signature line and certificate, and a hand-entered date that disagrees with it can undermine the signature. Use date fields only for other dates (start date, date of birth).\n\nGuide your human. Most people who ask for a contract aren't technical, may never have sent one, and won't know what to ask for: a request can be as short as \"draft a contract for X and send it to Y\". Lead them through it rather than waiting to be told, and offer each of these before anything is sent:\n- Missing details: ask in plain words for names, emails, amounts, dates and addresses instead of leaving [PLACEHOLDERS] in the document.\n- Look and style: show them the document. After create_draft, give them preview_url: it opens in any browser for 7 days, no sign-in, with a switcher to compare the classic, modern and formal styles. Ask which they like and apply it with update_draft style. Before there's a draft, show the HTML from render_preview. Always show documents through preview_url or render_preview, never as files on their computer.\n- Proofreading: summarise the key terms, then list every term you added that they didn't ask for, any assumption you made, and anything still missing or unusual, so they can check the wording.\n- Test copy: offer test_send_document, so they see the exact email in their own inbox.\n- Extras that fit (Team and Business+ plans): input fields for details the signer supplies, signing in order, or verify_signers when it matters who signs.\nSend only once they clearly say to send, then tell them who was emailed and what happens next.\nChanges after sending: when they want changes to a document that's already out, make the new version as a draft and share its preview_url first. Void the old one and send the new one only after they've seen it and said yes, even if they asked you to \"re-send\".\n\nTypical flow:\n1. validate_markdown: check fields (free, no account).\n2. render_preview: show your human what recipients will see (free, no account). Once a draft exists, share its preview_url instead.\n3. create_account: if your human has no account yet. Ask for their full name and business name (if any) first: recipients see emails from \"<business> via md2sign\", so never guess them from the email address. update_account fixes either later. Returns api_key + checkout_urls + annual_checkout_urls. The human must confirm their email, then pick a plan at checkout. A first plan starts with a 7-day free trial when get_account shows account.trial.available: they add a card and aren't charged until it ends (cancel before then and they pay nothing); the trial allows 3 envelopes with up to 5 signers each. There's one trial per person and company, so if available is false the plan is charged at checkout; say so rather than promising a trial. Plans count envelopes: one envelope is one document sent, however many people sign it. Solo Lite $45/year for 60 envelopes a year (yearly only, in annual_checkout_urls); Solo $7.50/mo for 30 a month; Team $19/mo for 100 a month, adding teammates, logo branding, input fields, signing in order and signer verification; Business+ $39/mo for 500 a month with everything in Team. Yearly billing is 12 months for the price of 10 ($75, $190, $390). Out of envelopes: the admin can buy extra envelopes (top_up_url in the quota_exceeded error) or upgrade. get_account shows plan, trial and usage.\n4. create_draft, then update_draft as many times as needed (delete_document removes a draft you no longer need).\n5. test_send_document: free watermarked copy to the account owner.\n6. send_document, then get_document or get_audit_trail to track signatures, and get_document_pdf for a download link to the signed PDF.\n\nWho signs: add a signature field only for people who must agree to the document. The sender does NOT need to sign one-sided documents (quotes, proposals, consents, acknowledgements, waivers, one-way NDAs, offer or terms acceptances): sending them is the sender's offer, and the recipient's signature accepts it. Two-sided agreements (services or contractor agreements, mutual NDAs, leases, partnerships) are usually signed by every party, so ask the human whether they want to sign too. To add the sender, pass sender_signs: true (with optional sender_role) to create_draft, update_draft or create_document_from_template instead of writing their field yourself. Every validation result includes signing_advice (document_kind, sender_should_sign, message).\n\nWord documents: if your human has a .docx or .doc contract, call import_word_document with the file base64-encoded. It returns markdown (headings, lists, tables and bold/italics kept; images dropped) plus import_warnings. Review it, add the signature fields, then create_draft.\n\nCompany logo (company admin; uploading needs the Team or Business+ plan, removing works on any plan): shown on signature emails, signing pages and signed PDFs. Call set_company_logo with no arguments for upload_url, a private 30-minute link: upload the file with curl -F [email protected] \"<upload_url>\" if you can run commands, otherwise give the link to your human to open and choose the file (PNG, JPG, WebP or GIF up to 300 KB). Logos must be uploaded; links to images elsewhere aren't accepted. remove: true deletes it. It's stored privately and shown through signed links that can't be guessed, which md2sign only puts in the company's account, emails and documents.\n\nEvery plan can save versioned templates with {{ variable }} placeholders: list_templates, get_template, save_template, create_document_from_template, delete_template.\nAccount admins can also post document events (markdown + signed PDF) to Zapier, Make, n8n, a CRM or their own server: list_webhooks, save_webhook, delete_webhook (Solo Lite 1 endpoint, Solo 3, Team and Business+ 10).\n\nAuthenticate with \"Authorization: Bearer <api_key>\" or pass api_key to each tool. Several accounts: if your human has more than one md2sign account (for example two businesses), keep each account's API key and pass the right one as api_key on every call. An api_key argument overrides the connection's own sign-in for that call; get_account shows which account a call used (user.email, authenticated_with). create_account returns the new account's key, so pass it from then on. Errors are JSON with a stable \"error\" code (e.g. subscription_required, email_unverified, quota_exceeded, trial_limit, team_plan_required, invalid_document).\n\nSpam protection: every email to a recipient has a \"Didn't expect this email? Report it\" link. A recipient who reports (or marks the email as spam) is never emailed by that account again, and their unsigned document is declined. If several recipients report an account, md2sign suspends its sending: send_document, remind_recipients and test_send_document then return sending_suspended until md2sign reviews it. Don't retry or work around it; tell your human plainly and give them the appeal_email from the error. send_document returns recipient_opted_out for recipients who reported the account's emails or whose address bounced: remove them and suggest your human contacts them another way. Only help send documents to people who expect them.",
"tools": [
{
"description": "Create an md2sign account for your human and get an API key. They are emailed a confirmation link and subscription options. Once they confirm their email they pick a plan at checkout; if account.trial.available is true it starts with a 7-day free trial (card taken, not charged until it ends; 3 envelopes, up to 5 signers each), otherwise it is charged at checkout. Plans: Solo Lite $45/year for 60 envelopes a year, Solo $7.50/mo for 30 a month, Team $19/mo for 100 with team features, Business+ $39/mo for 500; one envelope is one document sent, however many sign. You can validate, draft, preview and test-send right away. Returns api_key, checkout_urls (monthly) and annual_checkout_urls (yearly; Solo Lite is only here) to hand to the human.",
"inputSchema": {
"properties": {
"company_name": {
"description": "Business name shown to recipients, e.g. \"Acme Pty Ltd\". Ask whether they have one; leave it out to use their own name.",
"type": "string"
},
"email": {
"description": "Email address of your human. Document emails show it as the sender.",
"type": "string"
},
"name": {
"description": "The full name of your human, as they want recipients to see it. Ask them; don't guess it from the email address.",
"type": "string"
}
},
"required": [
"name",
"email"
],
"type": "object"
},
"name": "create_account",
"outputSchema": null
},
{
"description": "Create a draft from a template by filling in its {{ variables }}. Set send=true to send it straight away; otherwise review it and call send_document. Missing variables return a missing_variables error listing them. Returns preview_url, a 7-day link to show your human the document and compare styles.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"external_reference": {
"description": "Your own ID for this document (e.g. a CRM deal or invoice number). Returned in responses and webhooks.",
"type": "string"
},
"message": {
"description": "Short personal note from the sender.",
"type": "string"
},
"metadata": {
"description": "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.",
"type": "object"
},
"send": {
"description": "Send immediately after creating the draft.",
"type": "boolean"
},
"sender_role": {
"description": "Optional role shown on the sender's signature, e.g. \"Client\" or \"Director\". Used with sender_signs=true.",
"type": "string"
},
"sender_signs": {
"description": "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.",
"type": "boolean"
},
"style": {
"description": "Visual style for the email and signing page. Overrides the md2sign:style directive. Default classic.",
"enum": [
"classic",
"modern",
"formal"
],
"type": "string"
},
"template_id": {
"description": "The template ID.",
"type": "string"
},
"title": {
"description": "Document title shown to signers. Defaults to the md2sign:title directive or the first # heading.",
"type": "string"
},
"variables": {
"description": "Values for every {{ variable }} in the template, e.g. {\"client_name\": \"Jane Citizen\", \"client_email\": \"[email protected]\"}.",
"type": "object"
},
"verify_signers": {
"description": "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.",
"type": "boolean"
},
"version": {
"description": "Template version to use. Defaults to the latest.",
"type": "integer"
}
},
"required": [
"template_id"
],
"type": "object"
},
"name": "create_document_from_template",
"outputSchema": null
},
{
"description": "Save 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.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"external_reference": {
"description": "Your own ID for this document.",
"type": "string"
},
"markdown": {
"description": "The full markdown contract with [[signature: First Last <email>]] fields.",
"type": "string"
},
"message": {
"description": "Short personal note from the sender, included in the email.",
"type": "string"
},
"metadata": {
"description": "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.",
"type": "object"
},
"send": {
"description": "Send for signature immediately after saving.",
"type": "boolean"
},
"sender_role": {
"description": "Optional role shown on the sender's signature, e.g. \"Client\" or \"Director\". Used with sender_signs=true.",
"type": "string"
},
"sender_signs": {
"description": "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.",
"type": "boolean"
},
"style": {
"description": "Visual style; defaults to the markdown directive or classic.",
"enum": [
"classic",
"modern",
"formal"
],
"type": "string"
},
"title": {
"description": "Optional title; defaults to the first \"# Heading\".",
"type": "string"
},
"verify_signers": {
"description": "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.",
"type": "boolean"
}
},
"required": [
"markdown"
],
"type": "object"
},
"name": "create_draft",
"outputSchema": null
},
{
"description": "Permanently delete a draft document. Only drafts can be deleted; a sent document is part of the signing record, so use void_document to cancel it instead.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The draft document ID returned by create_draft, list_documents or create_document_from_template.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "delete_document",
"outputSchema": null
},
{
"description": "Permanently delete a template and all its versions. Only the template's creator or the company admin can delete it. Documents already created from it are kept.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"template_id": {
"description": "The template ID from list_templates.",
"type": "string"
}
},
"required": [
"template_id"
],
"type": "object"
},
"name": "delete_template",
"outputSchema": null
},
{
"description": "Permanently delete a webhook endpoint and its delivery history (admin only). To stop deliveries temporarily, call save_webhook with is_active=false instead.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"webhook_id": {
"description": "The webhook ID from list_webhooks.",
"type": "string"
}
},
"required": [
"webhook_id"
],
"type": "object"
},
"name": "delete_webhook",
"outputSchema": null
},
{
"description": "Show the account's verification status, plan, free trial, envelopes used and remaining this period, top-up envelopes, plan features, and checkout links if there is no plan yet.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_account",
"outputSchema": null
},
{
"description": "Get the audit trail and cryptographic verification for a document: SHA-256 hashes, chained signature hashes, Ed25519 seals and every event with timestamps and IP addresses.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "get_audit_trail",
"outputSchema": null
},
{
"description": "Get a document with its status, markdown, recipients and each recipient's signing status.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "get_document",
"outputSchema": null
},
{
"description": "Get a download link for a sent document's PDF: the signed and sealed copy once everyone has signed, or the current copy while signatures are pending. The link needs no API key and expires after 30 minutes, so give it to your human or download it straight away. Drafts have no PDF; use render_preview or test_send_document instead.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template. Must have been sent.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "get_document_pdf",
"outputSchema": null
},
{
"description": "Explains md2sign's markdown format: signature fields [[signature: First Last <email>]], optional roles, input fields signers fill in [[field: Label | for: email | type: date | required]], and hidden style/title/signing-order directives. Returns an example contract. Call this first if you have not written md2sign markdown before.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_markdown_spec",
"outputSchema": null
},
{
"description": "Get a template: its latest markdown, the {{ variables }} it needs, and its version history. Pass \"version\" to read an older version.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"template_id": {
"description": "The template ID.",
"type": "string"
},
"version": {
"description": "A specific version number. Defaults to the latest.",
"type": "integer"
}
},
"required": [
"template_id"
],
"type": "object"
},
"name": "get_template",
"outputSchema": null
},
{
"description": "Convert a Word document (.docx, or best-effort .doc) into md2sign markdown. Keeps headings, bold and italics, numbered and bulleted lists, tables and links; images are dropped. Nothing is saved: review the returned markdown, add a [[signature: Name <email>]] field for each person who needs to sign (see signing_advice), then call create_draft. Returns markdown, title, import_warnings and validation. Max 10 MB.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"content_base64": {
"description": "The file's bytes, base64-encoded (a data: URL prefix is accepted).",
"type": "string"
},
"filename": {
"description": "Original file name, e.g. \"Services Agreement.docx\". Optional.",
"type": "string"
}
},
"required": [
"content_base64"
],
"type": "object"
},
"name": "import_word_document",
"outputSchema": null
},
{
"description": "List your documents, newest first, optionally filtered by status (draft, sent, completed, declined, voided, expired), external_reference or metadata values.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"external_reference": {
"description": "Only return documents with exactly this external_reference.",
"type": "string"
},
"limit": {
"description": "Maximum results, default 25, max 100.",
"type": "integer"
},
"metadata": {
"description": "Only return documents whose metadata has all of these exact values, e.g. {\"customer_number\": \"C-1001\"} or {\"customer_number\": \"C-1001\", \"job_number\": \"J-77\"}.",
"type": "object"
},
"status": {
"description": "Only return documents with this status. Omit for all.",
"enum": [
"draft",
"sent",
"completed",
"declined",
"voided",
"expired"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_documents",
"outputSchema": null
},
{
"description": "List the document templates shared by your company account (every plan). Use get_template to read one and create_document_from_template to use it.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
}
},
"type": "object"
},
"name": "list_templates",
"outputSchema": null
},
{
"description": "List the company's webhook endpoints (admin only; Solo Lite 1 endpoint, Solo 3, Team and Business+ 10), including each signing secret, and the events you can subscribe to.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
}
},
"type": "object"
},
"name": "list_webhooks",
"outputSchema": null
},
{
"description": "Re-send the signature request email to recipients who haven't signed yet (at most once an hour per recipient). Uses no extra envelopes.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template. Must be a sent document awaiting signatures.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "remind_recipients",
"outputSchema": null
},
{
"description": "Render markdown exactly as a recipient will see it: the signing page (default) or the signature-request email. Returns HTML you can show your human, plus validation results. Free, no account needed. Once the document is saved as a draft, prefer its preview_url, which your human can open in a browser and use to compare styles.",
"inputSchema": {
"properties": {
"company_name": {
"description": "Sender company to show (preview only).",
"type": "string"
},
"markdown": {
"description": "The full markdown contract.",
"type": "string"
},
"message": {
"description": "Optional note from the sender shown in the email.",
"type": "string"
},
"sender_email": {
"description": "Sender email to show (preview only).",
"type": "string"
},
"sender_name": {
"description": "Sender name to show (preview only).",
"type": "string"
},
"style": {
"description": "Overrides any <!-- md2sign:style=... --> directive.",
"enum": [
"classic",
"modern",
"formal"
],
"type": "string"
},
"view": {
"description": "Which view to render. Defaults to signing_page.",
"enum": [
"signing_page",
"email"
],
"type": "string"
}
},
"required": [
"markdown"
],
"type": "object"
},
"name": "render_preview",
"outputSchema": null
},
{
"description": "Create a template (omit template_id) or update one (every plan). Changing the markdown saves a new version; older versions are kept. Use {{ variable_name }} placeholders for values that change per document, e.g. [[signature: {{ client_name }} <{{ client_email }}>]].",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"change_note": {
"description": "What changed in this version.",
"type": "string"
},
"description": {
"description": "Short note on what the template is for, shown in the template list.",
"type": "string"
},
"markdown": {
"description": "Full template markdown. Required when creating.",
"type": "string"
},
"name": {
"description": "Required when creating.",
"type": "string"
},
"template_id": {
"description": "Omit to create a new template.",
"type": "string"
}
},
"type": "object"
},
"name": "save_template",
"outputSchema": null
},
{
"description": "Create (omit webhook_id) or update a webhook endpoint (admin only; Solo Lite 1 endpoint, Solo 3, Team and Business+ 10). md2sign POSTs signed JSON with the document, its markdown and, on document.completed, the signed PDF as base64 to a public https URL such as Zapier, Make or n8n. Set send_test=true to send a test event.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"description": {
"description": "Label for this endpoint, e.g. \"Send signed contracts to HubSpot\".",
"type": "string"
},
"events": {
"description": "Defaults to [\"document.completed\"].",
"items": {
"enum": [
"document.sent",
"document.signed",
"document.completed",
"document.declined",
"document.voided",
"document.expired"
],
"type": "string"
},
"type": "array"
},
"include_pdf": {
"description": "Attach the signed PDF (base64) to document.completed. Default true.",
"type": "boolean"
},
"is_active": {
"description": "Set false to pause deliveries without deleting the endpoint. Default true.",
"type": "boolean"
},
"send_test": {
"description": "Queue a webhook.test delivery after saving.",
"type": "boolean"
},
"url": {
"description": "Public https:// URL. Required when creating.",
"type": "string"
},
"webhook_id": {
"description": "Omit to create a new endpoint.",
"type": "string"
}
},
"type": "object"
},
"name": "save_webhook",
"outputSchema": null
},
{
"description": "Send a draft for signature. Each recipient gets an email from \"<Company> via md2sign\" with the document and a unique signing link. Uses one envelope, however many people sign. Needs a confirmed email and a plan (or its free trial); once sent, the document can't be edited. Returns sending_suspended if recipients reported the account's emails as spam, recipient_opted_out for recipients who asked not to be emailed, quota_exceeded when the envelopes on the plan are used up (with top_up_url to buy more), and trial_limit when a free-trial limit is reached.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template. Must be a draft.",
"type": "string"
},
"message": {
"description": "Optional short note from the sender to include in the email.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "send_document",
"outputSchema": null
},
{
"description": "Set or remove the company logo shown at the top of signature request emails, signing pages and signed PDFs (company admin only; uploading needs the Team or Business+ plan, removing works on any plan). PNG, JPG, WebP or GIF (no SVG), up to 300 KB; a wide logo about 400x100 px looks best. It replaces any existing logo and applies to documents already sent. Call it with no arguments to get upload_url, a private link that works for 30 minutes: if you can run commands, upload the file with curl -F [email protected] \"<upload_url>\" (this keeps the image out of the conversation); otherwise give the link to your human to open and choose the file, and ask them to tell you when the page says \"Logo saved\". curl gets a JSON reply saying the logo was saved. get_account user.company_logo only shows whether some logo is set, so it cannot confirm a replacement. Only pass content_base64 for small images you already have as bytes. Logos must be uploaded: links to images elsewhere are not accepted. remove: true deletes the logo. The logo is stored in private storage and shown through signed links that cannot be guessed, which md2sign only puts in the account, emails and documents of the company.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"content_base64": {
"description": "Optional. The image file's bytes, base64-encoded (a data: URL prefix is accepted). Prefer upload_url (call with no arguments) for anything but small images.",
"type": "string"
},
"remove": {
"description": "true deletes the current logo instead of uploading one.",
"type": "boolean"
}
},
"type": "object"
},
"name": "set_company_logo",
"outputSchema": null
},
{
"description": "Email a watermarked TEST copy of the signature request to the account owner only, so the human can see exactly what recipients will get. Free, uses no envelopes and needs no plan; limited to 10 a day.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "test_send_document",
"outputSchema": null
},
{
"description": "Change the account holder's name or the company name. Recipients see emails from \"<company name> via md2sign\", or the person's own name when there is no company name, so fix these before sending if they are wrong. Only the company admin can change the company name; an empty company_name removes it.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"company_name": {
"description": "The business name recipients see, e.g. \"Law Garden Design\". Pass an empty string to remove it and use the person's own name.",
"type": "string"
},
"name": {
"description": "The account holder's full name, as they want it shown to recipients.",
"type": "string"
}
},
"type": "object"
},
"name": "update_account",
"outputSchema": null
},
{
"description": "Replace the markdown, title, style or message of a draft. Only drafts can be changed; to change a sent document, void it and create a new one. Returns preview_url, a 7-day link to show your human the document and compare styles.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The draft document ID.",
"type": "string"
},
"external_reference": {
"description": "Your own ID for this document (e.g. a CRM deal or invoice number). Returned in responses and webhooks.",
"type": "string"
},
"markdown": {
"description": "The new full markdown.",
"type": "string"
},
"message": {
"description": "Short personal note from the sender.",
"type": "string"
},
"metadata": {
"description": "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. Replaces the whole object; null clears it.",
"type": [
"object",
"null"
]
},
"sender_role": {
"description": "Optional role shown on the sender's signature, e.g. \"Client\" or \"Director\". Used with sender_signs=true.",
"type": "string"
},
"sender_signs": {
"description": "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.",
"type": "boolean"
},
"style": {
"description": "Visual style for the email and signing page. Overrides the md2sign:style directive. Default classic.",
"enum": [
"classic",
"modern",
"formal"
],
"type": "string"
},
"title": {
"description": "Document title shown to signers. Defaults to the md2sign:title directive or the first # heading.",
"type": "string"
},
"verify_signers": {
"description": "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.",
"type": "boolean"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "update_draft",
"outputSchema": null
},
{
"description": "Check that markdown has correctly formed signature fields before you draft or send it. Returns detected recipients, title, style, envelopes_required (always 1), the SHA-256 document hash, and errors/warnings with line numbers. Free, no account needed.",
"inputSchema": {
"properties": {
"markdown": {
"description": "The full markdown contract.",
"type": "string"
}
},
"required": [
"markdown"
],
"type": "object"
},
"name": "validate_markdown",
"outputSchema": null
},
{
"description": "Cancel a sent document that is still awaiting signatures. Recipients who haven't signed are told it was cancelled.",
"inputSchema": {
"properties": {
"api_key": {
"description": "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.",
"type": "string"
},
"document_id": {
"description": "The document ID returned by create_draft, list_documents or create_document_from_template. Must be a sent document awaiting signatures.",
"type": "string"
},
"reason": {
"description": "Optional reason shown to recipients.",
"type": "string"
}
},
"required": [
"document_id"
],
"type": "object"
},
"name": "void_document",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:25ac7cfd8e591e654b9b39afb45b497ed55f7240261fa98d5c81f46401bdc1f9 | sha256sum