# Yousign MCP MCP > Yousign manages secure electronic signatures for contracts and documents. Connect your agent to automate the full signing lifecycle—from drafting a new request to tracking signers' status and generating legal audit trails, all through natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** contract-signing, electronic-signature, security, authentication, workflow-automation ## Description You can use this MCP to manage entire contract lifecycles without ever leaving your AI client. Need to get an agreement signed? Your agent handles everything: it creates the initial signature requests, attaches documents, and assigns signers—all in a few steps. It tracks those signatures in real-time, letting you know exactly who has acted and what’s missing. When the contract is finished, you don't just get a document; you get a full audit trail that proves legal compliance. Because this process involves sensitive data, every single tool call runs inside Vinkius's secure sandbox environment, giving you confidence that your credentials are only used in transit and never stored on disk. You can also track everything that happens using the Vinkius AI Analytics dashboard, so nothing ever happens in the dark. ## Tools ### activate_signature_request Sends the active request out to the designated signers. ### add_document_to_request Uploads a document, like a PDF, and attaches it for signing purposes within an existing request. ### add_signer_to_request Specifies which people need to sign the contract and what their roles are in the process. ### cancel_ongoing_request Halts a signing request mid-process when it needs to be reworked or paused. ### create_signature_request Starts the entire process by creating the shell of a new signature agreement. ### create_yousign_contact Adds or updates a person's details into your address book for later use in signing requests. ### delete_signature_request Removes an incomplete draft signature request from the system. ### get_audit_trail_link Retrieves a direct link to the evidence file, containing all legal signatures and actions taken. ### get_signature_request Checks the current status of a specific signing request by its ID. ### get_workspace_details Retrieves general account information for your Yousign workspace. ### list_signature_requests Lists all signature requests you have made in the platform's history. ### list_yousign_contacts Retrieves a list of all contacts stored in your address book. ## Prompt Examples **Prompt:** ``` Create a new signature request named 'Annual Service Agreement'. ``` **Response:** ``` I've created the signature request 'Annual Service Agreement' (ID: req_8829). It's currently in draft status. Would you like to add signers or documents now? ``` **Prompt:** ``` Check the status of my ongoing signature requests. ``` **Response:** ``` You have 2 ongoing requests. 'Employment Contract' is pending signatures from 1 recipient, and 'NDA 2024' is fully signed and ready for download. ``` ## Capabilities ### Initiate Signature Requests Create a new signing process and manage multiple documents simultaneously. ### Manage Documents for Signing Upload PDFs or other files to attach them to an existing contract request. ### Add Specific Signers Define who needs to sign the agreement and what authentication methods they must use. ### Monitor Request Status Check in real-time whether a signing request is pending, completed, or stalled. ### Get Compliance Evidence Download the final signed document along with its full legal audit trail link. ## Use Cases ### Onboarding a new employee The HR team needs to get 15 new hires signed on employment contracts and NDAs. Instead of sending emails individually, the agent uses `create_signature_request` for all documents, then calls `add_signer_to_request` for each person, finally running `activate_signature_request`. The result is a batch process that finishes in minutes. ### Mid-deal contract revision A sales agreement needs an amendment. Instead of having to manually track down the old request, the agent uses `list_signature_requests` to find the draft ID, then calls `cancel_ongoing_request`, updates the document via `add_document_to_request`, and restarts the process. ### Legal compliance audit The legal team needs proof that a contract signed six months ago is still valid. The agent uses `get_audit_trail_link` on the completed request, instantly providing the necessary cryptographic evidence file without digging through old emails. ### Systematic contact cleanup Before sending out a mass contract package, the ops team uses `list_yousign_contacts` to verify that all key contacts are up-to-date. They then use `create_yousign_contact` to fix any missing or stale data points. ## Benefits - Accelerated deal closure: Use `create_signature_request` and follow up with `add_signer_to_request` to launch agreements instantly, cutting out email delays. - Compliance proofing: Whenever a contract finishes, call `get_audit_trail_link`. You get a single, tamper-proof file that proves every action taken on the document. - Workflow control: Need to pause or fix an agreement? Use `cancel_ongoing_request` before restarting the process with a fresh request. - Full visibility: Don't track statuses across multiple tabs. Your agent monitors everything through `get_signature_request`, giving you one source of truth for every pending contract. - Contact management: Keep your address book clean by first calling `create_yousign_contact` before assigning signers, ensuring all recipient details are correct. ## How It Works The bottom line is you tell your agent what needs signing, and the MCP executes all the necessary steps across Yousign's platform until the contract is complete. 1. Subscribe to this MCP and enter your Yousign API key into your client settings. 2. Use your agent to start by calling `create_signature_request` to set up the basic contract wrapper. 3. Next, call `add_document_to_request` and then `add_signer_to_request`, followed by `activate_signature_request` to get it moving. ## Frequently Asked Questions **How do I check if my contract signing request is still active using get_signature_request?** You run `get_signature_request` and provide the ID. The response immediately tells you its current status: whether it's pending, completed, or needs attention. **Do I need to use create_yousign_contact before adding a signer?** It’s best practice to call `create_yousign_contact` first. This ensures the system has the most current and accurate details for that person, preventing signup errors later on. **What happens if I need to change a document in an ongoing request?** You must call `cancel_ongoing_request` first. This stops the old process cleanly before you can use `add_document_to_request` and restart the flow. **How do I get proof of signing for legal records?** Use `get_audit_trail_link`. It pulls a cryptographically signed, complete evidence file that shows every action taken on the document, making it ready for compliance review. **How do I verify my account details or check API access using get_workspace_details?** You use `get_workspace_details` to confirm your connected account information. This is the first step to verifying that your credentials are correctly configured and accessible by your agent. **If a signature process stalls, how do I halt it using cancel_ongoing_request?** You call `cancel_ongoing_request` when you need to stop an active signing workflow immediately. This ensures the document is pulled out of circulation and can be restarted later. **What's the best way to get a list of all my pending contracts using list_signature_requests?** `list_signature_requests` gathers every signature request associated with your account. This lets you quickly see which documents are drafted, active, or completed. **Do I need to use create_yousign_contact first when running add_signer_to_request?** No, `add_signer_to_request` handles the recipient definition directly. You only need `create_yousign_contact` if you want to save that person's details into your main address book. **What is the difference between Draft and Ongoing status?** A 'draft' request is still being prepared (adding documents or signers). Once you 'activate' it, it becomes 'ongoing' and signers receive their invitations to sign. **How do I download a completed signed document?** When a request status is 'done', you can retrieve download links for each document using the 'get_signature_request' tool through your AI agent.