{"serverId":"mcp-registry/net.docuflex/esign","tools":[{"name":"create_envelope","fixed":{"name":"create_envelope","description":"Create a Docuflex envelope. documents: inline base64 PDFs or staged uploadIds. recipients: name, email, routingOrder (1 = first), optional type (signer default, cc, certified_delivery, in_person_signer...). tabs: type (signature, initial, date_signed, text, checkbox...), page (1-based), x/y/width/height as fractions of the page from the top-left, documentIndex and recipientIndex into this request's arrays. status 'sent' sends now; omit for a draft.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["subject","documents","recipients"],"properties":{"tabs":{"type":"array","items":{"type":"object","required":["documentIndex","recipientIndex","type","page","x","y","width","height"],"properties":{"x":{"type":"number","maximum":1,"minimum":0},"y":{"type":"number","maximum":1,"minimum":0},"page":{"type":"integer","minimum":1},"type":{"type":"string","maxLength":30},"label":{"type":"string","maxLength":120},"width":{"type":"number","maximum":1,"minimum":0},"height":{"type":"number","maximum":1,"minimum":0},"required":{"type":"boolean"},"documentIndex":{"type":"integer","minimum":0},"recipientIndex":{"type":"integer","minimum":0}},"additionalProperties":false},"maxItems":500},"status":{"enum":["draft","sent"],"type":"string"},"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"message":{"type":"string","maxLength":4000},"subject":{"type":"string","maxLength":200},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"documents":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":200},"base64":{"type":"string","description":"PDF bytes, base64"},"uploadId":{"type":"string"}},"additionalProperties":false},"maxItems":20,"minItems":1},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."},"recipients":{"type":"array","items":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":30},"email":{"type":"string","format":"email"},"clientUserId":{"type":"string","maxLength":120},"routingOrder":{"type":"integer","minimum":1}},"additionalProperties":false},"maxItems":50,"minItems":1},"routingType":{"enum":["sequential","parallel"],"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false},"title":"Create (and optionally send) an envelope"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":706,"tokensAfter":706},{"name":"esign_law_lookup","fixed":{"name":"esign_law_lookup","description":"High-level ESIGN / UETA / ESRA summary for a US state, the document types the federal act excludes, and what Docuflex records. Not legal advice.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["state"],"properties":{"state":{"type":"string","maxLength":30,"description":"Two-letter code or state name"}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"E-signature law for a US state"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":118,"tokensAfter":118},{"name":"get_audit_trail","fixed":{"name":"get_audit_trail","description":"Hash-chained audit events for an envelope, oldest first.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["envelope_id"],"properties":{"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."},"envelope_id":{"type":"string","maxLength":64}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"Audit trail"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":171,"tokensAfter":171},{"name":"get_envelope","fixed":{"name":"get_envelope","description":"Envelope status, recipients, documents.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["envelope_id"],"properties":{"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."},"envelope_id":{"type":"string","maxLength":64}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"Get an envelope"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":165,"tokensAfter":165},{"name":"get_signing_url","fixed":{"name":"get_signing_url","description":"Short-lived signing URL for a current-tier recipient (embedded signing). Provide the recipient's email or clientUserId as used on the envelope and a returnUrl.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["envelope_id"],"properties":{"email":{"type":"string","format":"email"},"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"userName":{"type":"string","maxLength":120},"returnUrl":{"type":"string","format":"uri"},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."},"envelope_id":{"type":"string","maxLength":64},"clientUserId":{"type":"string","maxLength":120}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"Embedded signing URL"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":250,"tokensAfter":250},{"name":"list_envelopes","fixed":{"name":"list_envelopes","description":"Most recent envelopes for the account.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"type":"integer","maximum":100,"minimum":1},"status":{"type":"string","maxLength":20},"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"List envelopes"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":171,"tokensAfter":171},{"name":"send_envelope","fixed":{"name":"send_envelope","description":"Transition a draft to sent.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["envelope_id"],"properties":{"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."},"envelope_id":{"type":"string","maxLength":64}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false},"title":"Send a draft envelope"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":162,"tokensAfter":162},{"name":"whoami","fixed":{"name":"whoami","description":"Works with an OAuth2 bearer token (user principal). Plain API keys are account-scoped and get 403 here; then use the account id from Account settings in the Docuflex app and pass it as account_id or x-docuflex-account.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"api_key":{"type":"string","maxLength":200,"description":"Docuflex API key (dfx_live_...). Optional if sent as the x-docuflex-api-key header."},"account_id":{"type":"string","maxLength":64,"description":"Docuflex account id. Optional if sent as x-docuflex-account or if the key belongs to exactly one account."}},"additionalProperties":false},"annotations":{"readOnlyHint":true},"title":"Resolve the caller's accounts"},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":193,"tokensAfter":193}],"toolsChanged":8,"tokensSaved":0,"todo":[{"tool":"create_envelope","params":["tabs","status","message","subject","metadata","documents","recipients","routingType"]},{"tool":"get_audit_trail","params":["envelope_id"]},{"tool":"get_envelope","params":["envelope_id"]},{"tool":"get_signing_url","params":["email","userName","returnUrl","envelope_id","clientUserId"]},{"tool":"list_envelopes","params":["limit","status"]},{"tool":"request_access","params":["name","email","company","message"]},{"tool":"send_envelope","params":["envelope_id"]},{"tool":"verify_envelope","params":["envelope_id"]},{"tool":"void_envelope","params":["reason","envelope_id"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}