Version 1.30.0
Two MCP servers are available. The full server at /mcp holds every tool. The Tvarka Proof server at /mcp/proof holds eight tools. It can never send a document for signature. It suits an agent that only needs proofs.
Add the server address in the agent settings. The person signs in once and allows the connection. The agent then works in that workspace.
BASE=https://sign-api.tvarka.pro
# TVARKA_KEY holds your API key.
curl -sS "$BASE/mcp/proof" \
-H "Authorization: Bearer $TVARKA_KEY" -H 'Content-Type: application/json' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'
Connector overview and setup guides: tvarka.eu/integrations/.
Install Tvarka Sign on Google Workspace Marketplace for individual or domain-wide administrator deployment. Send active Google Docs™ or selected Google Drive™ files for simple e-signature or eIDAS qualified signature directly from the sidebar, track per-signer status, download the evidence ZIP, and save completed signed PDFs back into your Tvarka Sign folder in Google Drive™. Connect your workspace once with Tvarka sign-in (no API key pasted into the card). Setup guide: tvarka.eu/google-workspace/.
Install n8n-nodes-tvarka-sign in self-hosted n8n through Settings → Community Nodes. Follow the maintained installation and credential guide and import the example workflow.
The connector uploads files, creates hosted qualified-signing requests, reads or lists them, downloads results, cancels requests and sends reminders. Use a Sign workspace key; DD and ATK keys are separate. It does not start headless signatures or the web application's simple e-signatures. Request creation is not signature completion.
The example needs your credentials and an uploaded file token. It explicitly sends email invitations, waits between status checks and downloads only after completion. Replace its example inputs before running; protect execution data and ceremony links. Existing sandbox keys simulate and return a sandbox-marked download. n8n Cloud installation requires n8n verification; npm publication alone does not establish Cloud availability.
GET /v1/capture-monitors - List the latest 100 capture monitorsPOST /v1/capture-monitors - Capture a page now and on a bounded recurring scheduleGET /v1/capture-monitors/{monitorId} - Read a monitorPATCH /v1/capture-monitors/{monitorId} - Pause or resume a monitorGET /v1/capture-bundles - List the latest 100 case bundlesPOST /v1/capture-bundles - Queue a URL list as one evidence bundleGET /v1/capture-bundles/{bundleId} - Read a case bundle and its capture outcomesGET /v1/capture-bundles/{bundleId}/file - Download the sealed manifest and all evidence files in one ZIPGET /v1/signings - List signingsPOST /v1/signings - Create a signingGET /v1/signings/{signingId} - Get a signingPATCH /v1/signings/{signingId} - Update a live signing deadlineDELETE /v1/signings/{signingId} - Erase one signingPOST /v1/batches - Raise one signing per document for one set of partiesGET /v1/batches/{batchId} - Poll a batch and every signing in itGET /v1/templates - List the workspace's templatesPOST /v1/templates - Save a templateGET /v1/templates/{templateId} - Get a templateDELETE /v1/templates/{templateId} - Delete a templatePOST /v1/templates/{templateId}/bulk-sends - Send a template to a list, one signing per rowGET /v1/bulk-sends/{bulkSendId} - Follow a listGET /v1/form-templates - List the published form templatesGET /v1/form-requests - Read the workspace's form requestsPOST /v1/form-requests - Ask a person to fill and sign formsGET /v1/form-requests/{formRequestId} - Get a form requestPATCH /v1/form-requests/{formRequestId} - Move, resend or cancel a form requestGET /v1/form-requests/{formRequestId}/document - Download the signed documentGET /v1/form-requests/{formRequestId}/evidence - Download the evidence ZIPGET /v1/form-requests/{formRequestId}/attachments - List or download the attachmentsGET /v1/kiosks - List the workspace's tabletsPOST /v1/kiosk-sessions - Send a PDF to a tabletGET /v1/kiosk-sessions/{kioskSessionId} - Read a kiosk sessionPATCH /v1/kiosk-sessions/{kioskSessionId} - Assisted mode on or off, or cancelGET /v1/kiosk-sessions/{kioskSessionId}/document - Download the signed PDFPOST /v1/signings/{signingId}/archive - Raise the signed output to a long-term levelPOST /v1/files - Store a document once for reuse across signingsPOST /v1/conversions - Convert an Office file or image to PDF/A-2bGET /v1/files/{fileToken} - Inspect a stored fileDELETE /v1/files/{fileToken} - Purge a stored fileGET /v1/signings/{signingId}/comments - Read the notes on a signingPOST /v1/signings/{signingId}/comments - Add a note to a signingPOST /v1/erasure - Erase terminal signings in bulkPOST /v1/signings/{signingId}/cancel - Cancel a signingGET /v1/signings/{signingId}/document - Download the signed documentGET /v1/signings/{signingId}/evidence - Download the evidence of a simple e-signaturePOST /v1/signings/{signingId}/signers - Add a signer to a live signingPATCH /v1/signings/{signingId}/signers/{signerId} - Update a pending signer's allowed methodsDELETE /v1/signings/{signingId}/signers/{signerId} - Remove a pending signerPOST /v1/signings/{signingId}/signers/{signerId}/remind - Remind one signerPOST /v1/signings/{signingId}/simulate - Drive a sandbox signing to an outcomeGET /v1/me - Who the key acts forGET /v1/webhooks - List webhook subscriptionsPOST /v1/webhooks - Subscribe a URL to signing eventsGET /v1/webhooks/deliveries - List recent webhook deliveriesPOST /v1/webhooks/deliveries/{deliveryId}/retry - Retry a webhook deliveryGET /v1/webhooks/{webhookId} - Get a webhook subscriptionDELETE /v1/webhooks/{webhookId} - UnsubscribePOST /v1/signatures - Start a headless signatureGET /v1/signatures/{signatureId} - State, current step and code, resultPOST /v1/signatures/{signatureId}/cancel - Cancel a pending signatureGET /v1/signatures/{signatureId}/document - Download the signed artifactPOST /v1/signatures/{signatureId}/simulate - Drive a sandbox signature to an outcomePOST /v1/timestamps - Put a qualified timestamp on a document, a hash or a web pageGET /v1/timestamps - The latest timestamps, newest firstGET /v1/timestamps/{timestampId} - One timestamp or web page captureGET /v1/timestamps/{timestampId}/file - The timestamped PDF, the ASiC-S container or the tokenTvarka Sign 1.21.0, Streamable HTTP at
/mcp, registry name pro.tvarka/sign. Documents
come from the workspace vault, Markdown text, a link, a chat attachment or
base64. See Agents: Claude, ChatGPT, Gemini, Copilot for one-click OAuth setup.
send_document - Send a document (an envelope) for signature: qualified (default, each signer uses their eID) or level "esign" (a simple e-signature on the page, no eID needed). Give the document exactly one way: markdown (Tvarka renders it to an A4 PDF; the first "# " heading becomes the title), pdfUrl (a public HTTPS link), pdfBase64, file (a file the user attached in the chat), or documentId (a document already in the vault). Each signer gets an email invitation. Set senderSigns to have the connected person sign first. Returns the signingId and each signer's status. Qualified: billed per signature on completion. esign: one charge per completed document.create_document - Render Markdown text to an A4 PDF and save it in the workspace vault without sending it. Returns the documentId of the saved document and a previewUrl (valid for one hour) where the user can check it.list_documents - Documents in the tenant workspace vault that can be sent for signing. Returns the documentId of each.request_signatures - Open a signing on a vault document for one or more signers, qualified (default) or level "esign". Returns a signing URL per signer, or emails them directly when delivery is "email". Qualified signers may take visibleSignature; the order snapshots shared workspace branding. Qualified: billed per signature on completion. esign: one charge per completed document.get_signing - The current state of one signing and each of its signers. Once completed, signedDocumentUrl downloads the signed document (valid for one hour).list_signings - Signings raised through this connection or key, newest first.add_signer - Add one more signer to a pending signing. In a sequential signing they sign last.remind_signer - Re-send one signer their invitation email. Limited to one reminder per signer per hour.cancel_signing - Retract every outstanding invitation and close the signing. Signatures already collected are untouched and remain valid.list_templates - Saved templates of the workspace: a document with its signer roles, signature type and order. Returns each templateId, its role names, and whether a role has a saved signer.send_from_template - Send a saved template in one step. Tvarka copies its document, keeps its signature type, order and signature placement, and invites one person per role. Every role without a saved signer needs an email. Returns the signingId and each signer's status. Billed like any signing.list_form_templates - Published Tvarka Formos templates of the workspace, each with its templateVersionId, its legal basis and its fields by semantic identifier, used to prefill a form request.send_forms - Create a Tvarka Formos request: the person gets a link by SMS (or email), fills the forms on their own phone and signs them once with Smart-ID or Mobile-ID. The link goes out three days before visitAt unless sendNow is true. Returns formRequestId and status. A completed request is billed as one e-signature document plus the qualified signature.get_form_request - Status, events and, once submitted, the values of a Tvarka Formos request.sign_now - The connected person signs a vault PDF now with a qualified signature, by Smart-ID or Mobile-ID on their own phone. Only the connected person can sign this way. Returns signatureId and a verificationCode. The person checks the code on the phone and enters the PIN. The signature status then reports progress. A second code can appear: the first step confirms who the person is, the second signs. Billed per signature once signed.get_signature - The state of one signature by the connected person: the current verification code (nextAction), and once signed, signedDocumentUrl to download the signed PDF (valid for one hour).timestamp_document - Put a qualified timestamp on a document. It proves the document existed in exactly this form at that moment. Give the document exactly one way: markdown (Tvarka renders it to an A4 PDF), fileUrl (a public HTTPS link), fileBase64 with fileName, file (a file the user attached in the chat), or documentId (a document already in the vault). A PDF comes back as the same PDF with the timestamp inside; any other file comes back in an ASiC-S container. Qualified by default; qualified false takes a cheaper non-qualified timestamp. Returns the code, verifyUrl (the public check page) and downloadUrl (valid for one hour). Billed per timestamp.certify_webpage - Open a public web page in a browser, capture how it looks now and seal the capture with a qualified timestamp. The result is a certificate PDF with the page address, the server answer, the time, a full screenshot, and the screenshot and the page HTML attached. Waits up to 25 seconds; a capture still running returns status pending with its timestampId. Give location to open the page from a chosen country, and optionally a state or a city and a ZIP, through a home internet connection there; the certificate then records the exit IP and where it is. locations (2 to 5 places) compares the same page side by side in one certificate. consent "reject" tests the cookie banner: the page as opened, then after clicking "reject all", with every tracker and cookie that still loads. device "mobile" opens it as a phone. recheckAt captures it again at that time, chained to this capture, with what changed. Every capture also records a video, the cookies and trackers that load before any click, the page's embedded data, who runs the domain, the site certificate, the latest earlier Internet Archive copy and a replayable web archive. Returns the code, verifyUrl and, once completed, downloadUrl (valid for one hour). Billed per completed capture.get_timestamp - The state of one timestamp or web page capture: status, the timestamp time, the code, verifyUrl, and once completed downloadUrl (valid for one hour).create_capture_monitor - Capture now and periodically. Normal per-capture prices; maxCaptures includes failed attempts. No overlapping runs. Defaults to every 24 hours and 30 captures.get_capture_monitor - Read the schedule, state and latest timestamp ID.update_capture_monitor - Pause future captures or resume from now. A queued capture continues; exhausted limits cannot be reset.create_capture_bundle - Queue 1 to 20 distinct URLs. Normal capture prices. Returns timestamp IDs; the finished ZIP includes a qualified timestamped manifest, numbered exhibits and failed capture outcomes.get_capture_bundle - Read capture outcomes and the authenticated ZIP download URL.Connect Tvarka Sign to your assistant once; then ask it to send a document
for signature, track it and fetch the signed original. Server URL:
https://sign-api.tvarka.pro/mcp. The assistant opens a Tvarka page,
you confirm with your eID, choose the company and allow the connection. It then
acts as you, with your rights in that company, and signatures are billed to the
company as usual. No key is pasted anywhere.
"httpUrl": "https://sign-api.tvarka.pro/mcp"). Gemini
Enterprise takes a fixed client: register one with
POST /oauth/register, redirect URI
https://vertexaisearch.cloud.google.com/oauth-redirect and
"token_endpoint_auth_method": "client_secret_post", then enter
the returned client ID and secret with authorization URL
https://sign-api.tvarka.pro/oauth/authorize and token URL
https://sign-api.tvarka.pro/oauth/token.Authorization: Bearer <key>
with your API key.What the assistant can do: write the document as text and have Tvarka render it to PDF/A, send a PDF from a link or a chat attachment, add you as the first signer, set a signing order and deadlines, remind, add signers, cancel, and hand you a download link for the signed document. It never signs: every signature is a person with their own eID. Connections are listed, with last use, under Settings, API settings, Connected apps, and end with one click.
Questions: info@tvarka.pro