GoodSign

Show the GoodSign account name and remaining credits. Each envelope sent costs 1 credit. Check this before bulk sending, or when the user asks "how many credits do I have?".

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Turn a PDF you PUT to a create_upload_url url into a GoodSign document. Call this only after the PUT has finished successfully. GoodSign discovers any text tags in the PDF (see create_upload_url for the full TAG REFERENCE and rules) and creates one field per tag plus one signer per distinct signer key automatically. This does NOT send anything or email anyone — the result behaves like a template: check it with get_document, then send it with send_from_template. The created document can only be sent once — to send the same PDF again, upload it again with create_upload_url and call this tool a second time. If the response includes warnings about unreadable tags, fix the tag text in the source document, re-export the PDF, call create_upload_url again and retry.

{
  "type": "object",
  "properties": {
    "upload_id": {
      "type": "string",
      "description": "The 40-character hex upload_id returned by create_upload_url, after the PUT to its upload_url has succeeded."
    },
    "doc_name": {
      "type": "string",
      "description": "Optional name for the document, e.g. \"SoW - Acme Q3\". Defaults to \"document\"."
    }
  },
  "required": [
    "upload_id"
  ],
  "additionalProperties": false
}

Get a short-lived URL to upload a PDF that GoodSign will turn into a document. Use this for a document that is NOT based on an existing GoodSign template — e.g. a Statement of Work, contract or NDA drafted for this specific deal. After the PUT succeeds, call create_document_from_upload with the upload_id this returns. The URL is valid for 15 minutes. If you are GENERATING the PDF yourself, embed text tags where fields should go — GoodSign places a real field at each tag's exact position, and each distinct KEY becomes one signer (reuse the same KEY on every tag that person fills). TAG REFERENCE — this is the complete list; any other tag type is discarded: - [sign|KEY] signature. [in|KEY] initials. Signature size variants: [signxs|KEY] [signsm|KEY] [signmd|KEY] [signlg|KEY] [signxl|KEY]. - [date|KEY] date of signing, filled in automatically. - [input|KEY] required text box. [input?|KEY] optional text box. [input|KEY|Some text] pre-filled, signer can edit. - [name|KEY] and [email|KEY] text boxes pre-filled with that signer's name / email address. - [c|KEY|Label] optional checkbox. [c*|KEY|Label] required checkbox. [c|KEY|x Label] pre-checked. [c1|KEY|Red] [c1|KEY|Blue] = radio group (same digit = one group, signer picks one). RULES — breaking any of these corrupts or silently drops fields: 1. KEY is the signer key: letters and digits ONLY (Client, signer1), identical spelling and case on every tag for that person. Keys differing only in case, spaces or punctuation collide into the wrong signer. Exception: trailing padding spaces before the closing ] (rule 4) are stripped before the key is matched, so [name|Client ] still keys to Client. 2. A tag must be one unbroken run of selectable text on a single line in a normal font — never an image, never wrapped across lines. 3. Do not use square brackets anywhere else in the document — prose like "[insert date]" gets parsed as a tag. Use parentheses instead. 4. The tag's printed size becomes the field's size: its font size sets the field height, and an input/name/email box is exactly as wide as the printed tag text — write the tag at the size you want the answer to be. To WIDEN an input/name/email field without making it taller, pad with trailing spaces INSIDE the tag before the ] — e.g. [name|Client ] — the spaces count toward the printed width but are stripped from KEY. Spaces after the ] do nothing. Print the tag in a monospace font (e.g. Courier) so each padding space adds a full, predictable character width. 5. Leave 2-3 blank lines of clear space around sign/in tags: the drawn signature renders much larger than the tag text. GoodSign erases the tag text from the final PDF and renders the field value in its place. After create_document_from_upload, confirm with get_document that the signer keys and field count match what you embedded.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Get an authenticated download URL for a document's PDF (including the audit certificate once complete). The URL requires the same `Authorization: Bearer` API key this MCP connection uses — download it with curl in a shell, do not try to fetch the bytes into the conversation.

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Document uuid"
    }
  },
  "required": [
    "uuid"
  ],
  "additionalProperties": false
}

Fetch full detail for one document OR template by uuid. For a template: shows the signer keys ("key" on each signer) and field keys that send_from_template requires — always check this before sending. For a sent document: shows status and per-signer progress (who has signed, who is pending). Timestamps are unix epoch seconds. Field entries show structural info only (key, type, page, which signer); signer-entered field values are never returned.

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Document or template uuid, from list_templates or list_documents"
    }
  },
  "required": [
    "uuid"
  ],
  "additionalProperties": false
}

List this account's documents filtered by status. Use status "sent" (default) to see envelopes still waiting on signatures, "complete" for fully signed ones. Use this to answer questions like "what is still waiting to be signed?" — then get_document on a uuid for per-signer detail.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "template",
        "sent",
        "complete",
        "voided",
        "archived"
      ],
      "description": "Filter status. Defaults to \"sent\"."
    }
  },
  "additionalProperties": false
}

List the reusable document templates in this GoodSign account. Call this first whenever the user wants to send a document — send_from_template needs a template uuid from here. Each template defines signer keys; call get_document with the template uuid to see exactly which signer keys and field keys it requires before sending.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Re-send the signing invitation email to signers who have not completed yet. Omit signer_email to remind ALL pending signers of the document; pass signer_email to remind one specific person. Sends real email — do not call repeatedly; once per day per signer is plenty.

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Document uuid (a sent document, not a template)"
    },
    "signer_email": {
      "type": "string",
      "description": "Optional: remind only this signer"
    }
  },
  "required": [
    "uuid"
  ],
  "additionalProperties": false
}

Send a document for e-signature using a template. THIS EMAILS REAL PEOPLE and spends 1 credit — confirm each signer's name and email with the user before calling, or set draft=true to stage without emailing anyone. Requires one signers[] entry per signer key on the template (get_document on the template uuid lists the keys). For sequential signing set send_in_order=true: signers are emailed one at a time, in the order of the signers array (or explicit send_order values, lower first). Pre-fill text fields with fields[] using the field keys from get_document.

{
  "type": "object",
  "properties": {
    "template_uuid": {
      "type": "string",
      "description": "Template uuid from list_templates"
    },
    "signers": {
      "type": "array",
      "description": "One entry per signer key defined on the template. Every key must be covered.",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "Signer key from the template (shown as `key` by get_document), e.g. \"signer1\""
          },
          "name": {
            "type": "string",
            "description": "Signer full name"
          },
          "email": {
            "type": "string",
            "description": "Real deliverable email address. Placeholders like \"TBC\" are rejected."
          },
          "send_order": {
            "type": "integer",
            "description": "Optional, only with send_in_order=true: explicit release position, lower sends first. Defaults to array order."
          },
          "reminder_days": {
            "type": "number",
            "description": "Optional: auto-remind this signer every N days until they sign"
          }
        },
        "required": [
          "key",
          "name",
          "email"
        ]
      }
    },
    "fields": {
      "type": "array",
      "description": "Optional pre-filled field values (field keys come from get_document on the template)",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "value"
        ]
      }
    },
    "doc_name": {
      "type": "string",
      "description": "Optional name for the sent document, e.g. \"NDA - Acme Pty\""
    },
    "email_subject": {
      "type": "string",
      "description": "Optional subject for the signing invitation email"
    },
    "email_message": {
      "type": "string",
      "description": "Optional message shown inside the signing invitation email"
    },
    "cc_email": {
      "type": "string",
      "description": "Optional comma-separated CC addresses, notified when signing completes"
    },
    "send_in_order": {
      "type": "boolean",
      "description": "true = sequential signing (signer 2 is only emailed after signer 1 completes)"
    },
    "draft": {
      "type": "boolean",
      "description": "true = prepare the document but do NOT email anyone. Use when the user wants to review first."
    }
  },
  "required": [
    "template_uuid",
    "signers"
  ],
  "additionalProperties": false
}

Cancel a sent document so nobody can sign it anymore. This cannot be undone — to re-send, use send_from_template again. By default signers are notified the document was voided; set notify=false to void silently. Confirm with the user before voiding.

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "Document uuid to void"
    },
    "message": {
      "type": "string",
      "description": "Optional reason shown to signers in the void notification"
    },
    "notify": {
      "type": "boolean",
      "description": "Notify signers by email (default true)"
    }
  },
  "required": [
    "uuid"
  ],
  "additionalProperties": false
}