# Yousign MCP MCP > Yousign MCP manages your entire electronic signature workflow. Use it to create document requests, add specific signers by contact details, track real-time status updates across multiple parties, or permanently cancel a request if needed. It handles the full lifecycle of legally binding signatures for European operations. ## Overview - **Category:** document-management - **Price:** Free - **Tags:** electronic-signature, eidas-compliance, document-workflow, signer-verification, contract-signing ## Description Need to manage contracts and approvals without logging into a web dashboard? This MCP lets your AI agent run your entire signature process through natural conversation. You can create initial drafts for requests, define who needs to sign by adding specific people, and then monitor the whole thing from one place. It tracks everything: whether a document is in draft mode, if it's ongoing, or if it's done. If things go sideways, you can permanently stop the request using simple commands. For complex legal operations, this ability to track every stage of the signature process matters. Because credentials pass through a zero-trust proxy on Vinkius, your API keys never sit on disk; they're only used in transit for security. You get a complete history of actions and data flow—a cryptographically signed audit trail—which is essential when managing legal paperwork. ## Tools ### activate_request Sends email notifications to all signers, turning a draft request into an active, trackable workflow. ### add_signer Adds one or more specific people by providing the request ID and their contact details. ### cancel_request Stops an ongoing signature process entirely, requiring a reason for termination. ### create_request Sets up a new document signing workflow in draft mode using just a descriptive name. ### get_consumption Pulls reports on your API usage, showing remaining credits and overall consumption metrics. ### get_request Retrieves the current details and status for a specific signature request ID. ### list_documents Lists every single file attached to a given request, allowing you to verify the contents before activation. ### list_requests Provides a list of all signature requests managed within your organization's account. ## Prompt Examples **Prompt:** ``` List all ongoing signature requests in Yousign. ``` **Response:** ``` I found 3 ongoing requests: 1. 'Partnership Agreement' (ID: req-101), 2. 'Employment Contract - John' (ID: req-102), and 3. 'Vendor Terms' (ID: req-103). Would you like to see the signer status for any of these? ``` **Prompt:** ``` Add 'Jane Smith' (jane@example.com) as a signer to request ID 'req-101'. ``` **Response:** ``` Success! I've added Jane Smith as a signer to the 'Partnership Agreement' (req-101). Would you like to add more signers or activate the request now? ``` **Prompt:** ``` Check our current API consumption and credits. ``` **Response:** ``` You have consumed 45 out of 100 signatures in your current billing cycle. You have 55 signature credits remaining. Would you like me to list the most recent signed documents? ``` ## Capabilities ### Initiate new requests Starts a signature process from scratch, leaving the document in draft mode. ### Manage signers and contacts Adds specific people to an existing request by providing their necessary contact details. ### Monitor and retrieve status Checks the current state of any signature process, whether it's pending or complete. ### Finalize document lists Retrieves all files attached to a specific request so you can verify contents before sending. ### Cancel and audit requests Stops an active signing process permanently, providing a reason for cancellation or checking your usage quota. ## Use Cases ### The HR team needs to onboard three new employees quickly. Instead of sending emails manually, the agent first calls `create_request` for the employment contract. Then it uses `add_signer` repeatedly with the contact details for all three people, and finally activates everything in one go. ### Legal needs to review a potential agreement before signing. The agent checks the document contents first by calling `list_documents`. If the right files aren't there, it alerts you. This prevents accidentally sending out an incomplete contract. ### A deal falls through and needs to be shut down legally. The agent locates the active request using its ID and calls `cancel_request`, automatically logging a reason for termination. This provides necessary audit proof that the workflow was stopped correctly. ### Operations needs to know if they can handle next month's volume. The agent runs a report using `get_consumption` to check current API usage, providing an immediate count of remaining signature credits without needing to log into the billing portal. ## Benefits - Stop manually checking dashboards. Use `list_requests` to see all ongoing workflows and get a single overview of your organization's signing activity. - Control the process flow entirely. You can use `create_request` to start drafts, then add signers via `add_signer`, making it easy to build complex approval chains. - Stay compliant and audit-ready. The system tracks everything, giving you a clear record of status changes or when you need to call `cancel_request`. - Never run out of credits without knowing. Use `get_consumption` to check your API quota before initiating any major workflow batch. - Verify documents instantly. Before activating a request, use `list_documents` to confirm every file attached is correct and up-to-date. ## How It Works The bottom line is that your agent treats the entire document workflow like a structured conversation, handling creation, population, and status checks without manual intervention. 1. First, use the agent to create a draft signature request and provide its descriptive name. 2. Next, add all necessary signers by giving the system the specific Request ID and their contact information. You can then activate the request to send notifications. 3. Finally, check the status of the signing process using the Request ID to confirm if it's completed or where exactly it stalled. ## Frequently Asked Questions **How do I check which requests are currently active using `list_requests`?** The agent calls `list_requests` and returns a summary of all workflows managed by your account. This list includes the request names and unique IDs, helping you select which one needs attention. **Can I add multiple signers at once using `add_signer`?** Yes, you provide the Request ID along with all the necessary contact details for every person. The agent adds them sequentially to the existing draft request. **What is the best way to check my API usage? Should I use `get_consumption`?** To see how many signatures you've used and what your remaining quota is, call `get_consumption`. This gives you a clear number showing exactly where you stand with your billing plan. **If I need to stop a contract that wasn't signed yet, should I use `cancel_request`?** Yes, `cancel_request` permanently stops the workflow. You must provide the Request ID and an optional reason for cancellation so it’s properly audited. **How do I verify all files attached to a signing request before activating it, using `list_documents`?** You use `list_documents` and provide the specific Request ID. This pulls a list of every document associated with that signature process. It's your chance to audit the contents—check file names and IDs—before you send anything out. **What is the best way to start an entirely new signing flow? Should I use `create_request` first?** Yes, always run `create_request` first and give it a descriptive name. This puts the process into draft mode immediately. You get a unique Request ID, which you need for every subsequent step, like adding signers or activating the flow. **If I need the detailed status of only one specific contract, should I use `get_request`?** Use `get_request` and provide just a single Request ID. This pulls comprehensive, real-time data for that exact signing instance. You see who signed it, when they signed it, and what the current status is, without pulling all other requests. **After I've set up signers, how do I actually push the documents out? Do I use `activate_request`?** Yes, running `activate_request` sends the official email notification to every signer you added. This moves the document from draft status into an active workflow state, letting them know they need to sign. **Can I check the status of a signature request via chat?** Yes. The `get_signature_request` tool allows your AI agent to retrieve the real-time status of any request ID, showing you whether it is in 'draft', 'ongoing', 'done', or has been 'cancelled'. **How do I add signers to a draft request using the agent?** You can use the `add_signer` tool. Provide the unique request ID along with the signer's email, first name, and last name. You can add multiple signers to a single request before activating it. **Can I see how many signature credits I have left in my plan?** Absolutely. Use the `get_api_consumption` tool to retrieve your current usage statistics and remaining signature credits, helping you manage your Yousign subscription budget.