Server definition

Hash: sha256:bb737796505e403052a38a3b5a75bdce7a70defa3b280150342962a2112517ff
What it is: What a remote MCP server returned when asked what it offers: 10 tools

The blob, as servednamed by its sha256

{
  "instructions": "GoodSign sends documents for e-signature. Pricing is per envelope: sending one document (any number of signers) costs 1 credit. Check remaining credits with account_status.\n\nTypical workflow:\n1. list_templates — find the template the user wants to send.\n2. get_document with the template's uuid — learn the signer keys (and optional field keys) that template requires.\n3. send_from_template — provide one signers[] entry per signer key. THIS EMAILS REAL PEOPLE and spends 1 credit: confirm names and email addresses with the user before sending, or pass draft=true to stage without emailing.\n4. list_documents / get_document — track signing progress. Use remind_signers to nudge, void_document to cancel, download_document once complete.\n\nSending a document you generated (not from a template):\n1. create_upload_url — get a short-lived PUT url + upload_id. If you are generating the PDF yourself, embed text tags like [sign|Client] where fields should go — signatures, initials, date-signed, text boxes and checkboxes are supported; follow the TAG REFERENCE and rules in the create_upload_url tool description exactly.\n2. PUT the PDF to that url, e.g. `curl -T file.pdf -H \"Content-Type: application/pdf\" \"<upload_url>\"`.\n3. create_document_from_upload with the upload_id — discovers tags, creates fields and signers, returns a document uuid.\n4. get_document uuid=... — confirm the signer keys GoodSign found.\n5. send_from_template — same as the template flow above.\n\nConventions:\n- Documents and templates are identified by uuid.\n- Statuses: draft, template, sent, complete, voided, archived.\n- Timestamps are unix epoch seconds.\n- Signer emails must be real deliverable addresses. Placeholders like \"TBC\" are rejected.\n- Never invent a signer's email address — if the user hasn't provided it, ask them.",
  "tools": [
    {
      "description": "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?\".",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "account_status",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "doc_name": {
            "description": "Optional name for the document, e.g. \"SoW - Acme Q3\". Defaults to \"document\".",
            "type": "string"
          },
          "upload_id": {
            "description": "The 40-character hex upload_id returned by create_upload_url, after the PUT to its upload_url has succeeded.",
            "type": "string"
          }
        },
        "required": [
          "upload_id"
        ],
        "type": "object"
      },
      "name": "create_document_from_upload",
      "outputSchema": null
    },
    {
      "description": "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.\n\nIf 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).\n\nTAG REFERENCE — this is the complete list; any other tag type is discarded:\n- [sign|KEY] signature. [in|KEY] initials. Signature size variants: [signxs|KEY] [signsm|KEY] [signmd|KEY] [signlg|KEY] [signxl|KEY].\n- [date|KEY] date of signing, filled in automatically.\n- [input|KEY] required text box. [input?|KEY] optional text box. [input|KEY|Some text] pre-filled, signer can edit.\n- [name|KEY] and [email|KEY] text boxes pre-filled with that signer's name / email address.\n- [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).\n\nRULES — breaking any of these corrupts or silently drops fields:\n1. 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.\n2. 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.\n3. Do not use square brackets anywhere else in the document — prose like \"[insert date]\" gets parsed as a tag. Use parentheses instead.\n4. 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.\n5. Leave 2-3 blank lines of clear space around sign/in tags: the drawn signature renders much larger than the tag text.\n\nGoodSign 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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "create_upload_url",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "uuid": {
            "description": "Document uuid",
            "type": "string"
          }
        },
        "required": [
          "uuid"
        ],
        "type": "object"
      },
      "name": "download_document",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "uuid": {
            "description": "Document or template uuid, from list_templates or list_documents",
            "type": "string"
          }
        },
        "required": [
          "uuid"
        ],
        "type": "object"
      },
      "name": "get_document",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "status": {
            "description": "Filter status. Defaults to \"sent\".",
            "enum": [
              "draft",
              "template",
              "sent",
              "complete",
              "voided",
              "archived"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_documents",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_templates",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "signer_email": {
            "description": "Optional: remind only this signer",
            "type": "string"
          },
          "uuid": {
            "description": "Document uuid (a sent document, not a template)",
            "type": "string"
          }
        },
        "required": [
          "uuid"
        ],
        "type": "object"
      },
      "name": "remind_signers",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "cc_email": {
            "description": "Optional comma-separated CC addresses, notified when signing completes",
            "type": "string"
          },
          "doc_name": {
            "description": "Optional name for the sent document, e.g. \"NDA - Acme Pty\"",
            "type": "string"
          },
          "draft": {
            "description": "true = prepare the document but do NOT email anyone. Use when the user wants to review first.",
            "type": "boolean"
          },
          "email_message": {
            "description": "Optional message shown inside the signing invitation email",
            "type": "string"
          },
          "email_subject": {
            "description": "Optional subject for the signing invitation email",
            "type": "string"
          },
          "fields": {
            "description": "Optional pre-filled field values (field keys come from get_document on the template)",
            "items": {
              "properties": {
                "key": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "key",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "send_in_order": {
            "description": "true = sequential signing (signer 2 is only emailed after signer 1 completes)",
            "type": "boolean"
          },
          "signers": {
            "description": "One entry per signer key defined on the template. Every key must be covered.",
            "items": {
              "properties": {
                "email": {
                  "description": "Real deliverable email address. Placeholders like \"TBC\" are rejected.",
                  "type": "string"
                },
                "key": {
                  "description": "Signer key from the template (shown as `key` by get_document), e.g. \"signer1\"",
                  "type": "string"
                },
                "name": {
                  "description": "Signer full name",
                  "type": "string"
                },
                "reminder_days": {
                  "description": "Optional: auto-remind this signer every N days until they sign",
                  "type": "number"
                },
                "send_order": {
                  "description": "Optional, only with send_in_order=true: explicit release position, lower sends first. Defaults to array order.",
                  "type": "integer"
                }
              },
              "required": [
                "key",
                "name",
                "email"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "template_uuid": {
            "description": "Template uuid from list_templates",
            "type": "string"
          }
        },
        "required": [
          "template_uuid",
          "signers"
        ],
        "type": "object"
      },
      "name": "send_from_template",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "message": {
            "description": "Optional reason shown to signers in the void notification",
            "type": "string"
          },
          "notify": {
            "description": "Notify signers by email (default true)",
            "type": "boolean"
          },
          "uuid": {
            "description": "Document uuid to void",
            "type": "string"
          }
        },
        "required": [
          "uuid"
        ],
        "type": "object"
      },
      "name": "void_document",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:bb737796505e403052a38a3b5a75bdce7a70defa3b280150342962a2112517ff | sha256sum