# Yousign MCP > Yousign connects your eSignature workflow directly into your AI client. Manage entire document lifecycles, from creating a draft request to tracking final signatures, all through natural conversation. This MCP lets you list requests, add signers by contact details, and audit API usage without ever logging into the Yousign dashboard. ## Overview - **Category:** document-management - **Price:** Free - **Tags:** electronic-signature, eidas-compliance, document-workflow, signer-verification, contract-signing ## Description Yousign gives your AI agent full control over your electronic signature infrastructure. You don't need to manually log in anymore. Instead, you talk to your agent—whether it’s Claude or Cursor—and tell it what needs signing. It handles everything: generating new draft requests and adding the necessary signers using their email addresses. If a request is ready, you can activate it instantly. Your agent also tracks status; need to know if an agreement stalled? You can list all ongoing signature processes right through chat. Plus, it keeps tabs on your quota, so you always know how many signatures you have left for the month. ## Tools ### list_requests Retrieves a comprehensive list of all signature requests within the Yousign organization. ### get_request Pulls specific details and the current status for one designated signature request ID. ### create_request Starts a brand new signature process, generating it in draft mode under a specified name. ### add_signer Attaches one or more signers to an existing draft request using their contact information. ### activate_request Triggers the sending of a draft signature request via email notifications to all assigned signers. ### cancel_request Permanently stops an active signing process and requires you to provide a reason for termination. ### list_documents Shows all the files currently attached to a specific signature request, letting you verify contents before activation. ### get_consumption Reports your current API usage and credit remaining count for accurate plan monitoring. ## 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 ### View and Track Requests You can view a complete list of all signature requests in your organization to see their current status. ### Build Signature Requests The agent drafts new signing requests for you, allowing you to start the process without manually building it out. ### Add Participants and Documents You add signers by providing their contact information, or list all documents attached to a specific request before activating it. ### Activate or Cancel Signatures Send requests out via simple commands, or permanently stop an active signing process and provide a cancellation reason. ### Manage Usage Quotas The agent pulls your API consumption data so you can monitor credit usage against your plan limits. ## Use Cases ### The Legal Audit Check A compliance officer needs to know if all vendor agreements signed last week are still active and complete. They ask their agent to `list_requests`, filter for 'vendor', and then use `get_request` on the IDs returned, instantly confirming the status of every document without opening dozens of tabs. ### The New Hire Onboarding An HR manager needs to get a new employee's contract signed. They ask their agent to `create_request` for the 'Employment Contract,' use `add_signer` with the new hire's email, and then hit `activate_request`, sending it out immediately. ### The Stalled Agreement A sales rep realizes a key partnership agreement is stuck in limbo. They tell their agent to check the request ID with `get_request` first, and if it's stalled, they use `cancel_request`, providing the necessary reason for termination. ### Pre-Send Document Verification Before sending a complex agreement, an operations manager wants to double-check that all required legal documents are attached. They instruct their agent to run `list_documents` against the request ID, verifying contents before hitting 'send'. ## Benefits - Audit usage and manage credits instantly. Instead of guessing how many signatures you have left, run the `get_consumption` tool to monitor your quota in real time. - Avoid manual data entry for signers. Simply tell your agent who needs to sign; it uses the `add_signer` tool to attach their contact details automatically. - Manage the full lifecycle without clicks. You can use `create_request` to draft a document, then `add_signer`, and finally `activate_request`—all in one conversation thread. - Immediate visibility into stalled agreements. Use `list_requests` or `get_request` to track exactly which processes are ongoing and who hasn't signed yet. - Control the workflow with precision. If a contract needs to stop, use `cancel_request` instead of navigating through settings to terminate it. ## How It Works The bottom line is that your signing platform becomes an operational assistant accessible entirely through conversation. 1. Subscribe to the Yousign MCP and provide your unique API Key. 2. Talk to your AI client. Tell it what document workflow you need—like listing all current requests or adding a new signer. 3. The agent executes the action through Yousign, giving you real-time status updates without leaving your chat window. ## Frequently Asked Questions **How do I list all my outstanding contracts with Yousign MCP?** You use the `list_requests` tool to get a comprehensive view of every signature request in your organization. This gives you IDs and overall statuses immediately. **Can I add multiple signers at once using Yousign MCP?** Yes, you can use the `add_signer` tool to attach new participants by providing their contact details directly within your chat command. It's much faster than manual input. **What if I need to stop a signing request? Do I have to delete it manually?** No, you use the `cancel_request` tool. This permanently stops an ongoing process and forces you to provide a reason for cancellation, ensuring compliance. **Does Yousign MCP help me track my API usage?** Absolutely. Run the `get_consumption` tool anytime you need to know your current credit status against your plan limits. It keeps your workflow running smoothly.