# eSign (e签宝) MCP

> eSign (e签宝) connects your AI agent to China's premier digital signature platform. Manage entire contract lifecycles—from creating initial workflows to tracking signatures and downloading final documents—all through natural conversation with no need to navigate the eSign portal.

## Overview
- **Category:** document-management
- **Price:** Free
- **Tags:** contract-lifecycle, digital-signing, workflow-automation, templates, compliance

## Description

Your agent handles complex agreements, making document signing feel like a simple chat. Instead of logging into a separate portal, your AI client can instantly manage your legal operations. You can ask it to list existing sign flows or create an entirely new one by specifying documents and people. It automatically manages templates, letting you pull from predefined agreement types. When the flow is ready, your agent finds the correct signing link for each participant; later, once everyone signs, you just tell it to download the final agreements. This capability makes managing high-volume employee contracts or complex B2B deals simple and secure, all managed through a single connection via Vinkius.

## Tools

### get_sign_flow
Fetches the full details and current status of a specific, existing sign flow.

### list_sign_flows
Retrieves a list of all active or past signing workflows managed in your account.

### list_templates
Shows a catalog of predefined document templates that can be reused for new contracts.

### add_docs
Adds necessary PDF documents to an existing signing workflow or task.

### get_org_info
Retrieves high-level account information about your eSign organization details and status.

### download_docs
Retrieves the final, signed documents from a completed flow.

### add_signers
Adds specific people who need to sign the agreement to a defined flow.

### create_sign_flow
Initiates and sets up an entirely new digital signature workflow.

### get_execute_url
Provides the specific web link required for a participant to sign their document.

### start_flow
Begins the process of creating and managing a digital signature workflow from scratch.

## Prompt Examples

**Prompt:** 
```
List all active signature flows on eSign.
```

**Response:** 
```
I've retrieved your active eSign flows. You have 5 tasks in progress, including 'Service Agreement - Client A' and 'New Employee Offer'. Which one would you like to check the status for?
```

**Prompt:** 
```
Get the signing URL for account 'acc-8821' in flow 'flow-9920'.
```

**Response:** 
```
I've retrieved the execution URL for the participant. You can send this link to the signer to complete the process: [URL].
```

**Prompt:** 
```
Show me all available document templates.
```

**Response:** 
```
I've listed your eSign document templates. You have 3 templates ready for use: 'Standard NDA', 'Employment Contract v2', and 'Sales Agreement'. Would you like to use one of these for a new sign flow?
```

## Capabilities

### Set up document workflows
The agent can create brand new digital signing flows by defining the documents needed and the people who must sign them.

### Manage templates
You tell your AI client to pull predefined contract types, accelerating the creation of standardized agreements.

### Track signature status
The system provides real-time updates on active sign flows and retrieves necessary URLs for participants to complete their signing.

### Build agreement packages
You can attach PDF documents to an existing flow or task, ensuring all relevant papers are included before signing begins.

### Get organizational status
The agent retrieves high-level details about your eSign account and current authorization limits.

## Use Cases

### The onboarding process stalled because of manual tracking.
An HR manager needs to know if 20 new hires have signed their agreements. Instead of logging into the portal, they ask their agent to list_sign_flows. The agent instantly confirms which contracts are pending and provides status updates.

### A legal team needs a standard contract for a new client.
The lawyer prompts their agent to call list_templates, pulling up the 'Master Service Agreement.' They then use start_flow to begin the workflow immediately, skipping template searches and manual setup.

### A sales rep needs to follow up on a stalled client signature.
The rep asks their agent for the signing link. The agent runs get_execute_url for the specific participant, giving them the direct URL needed to send to the client and push the contract forward.

### A project lead needs to bundle final paperwork from multiple agreements.
Once several flows are completed, the agent is asked to download_docs. It retrieves all signed contracts into one secure package, eliminating manual downloads and file consolidation.

## Benefits

- You stop wasting time manually checking status updates. By using list_sign_flows, your agent gives you an instant overview of every active agreement in progress.
- Template creation speeds up drafting dramatically. Asking for list_templates immediately provides a selection of pre-vetted documents like NDAs or employment contracts.
- Getting the sign link is simple. Instead of navigating deep menus to find a participant's URL, calling get_execute_url gives you the exact link right away.
- The whole process becomes conversational. You don't write boilerplate API calls; you just tell your agent what needs signing and who needs to sign it.
- Compliance checks are easier. By using add_docs and create_sign_flow together, you ensure every document is attached and the workflow is structured correctly before sending.

## How It Works

The bottom line is that you use natural language prompts in your AI client instead of clicking through multiple eSign menus.

1. Subscribe to this MCP, then enter your required eSign App ID and App Secret into your AI client.
2. Ask your agent for a specific action, like listing all active flows or creating a new signing workflow using predefined templates.
3. Your agent executes the command, providing real-time status updates or generating necessary download links to complete the process.

## Frequently Asked Questions

**How do I check if a signing flow is active using eSign MCP?**
You use list_sign_flows. This command retrieves all your current and pending workflows, letting you know exactly what agreements are in progress.

**Can I start a new contract without knowing the template name first? (eSign MCP)**
No, you should list_templates first to see available options. This ensures you use a standardized and pre-approved agreement type for your workflow.

**What tool do I use to get the actual link for signing? (eSign MCP)**
You must call get_execute_url. This retrieves the unique, actionable web link that you can send directly to the participant who needs to sign.

**Does eSign MCP handle multiple documents in one flow?**
Yes. You use add_docs and create_sign_flow together. This allows you to bundle several different PDF agreements into a single, coherent signing workflow.

**How do I find my eSign App ID and Secret?**
Log in to the [eSign Open Platform](https://open.esign.cn/), create a new application, and you will find your App ID and App Secret in the application credentials section.

**Can I retrieve the signing URL for a participant?**
Yes. Use the `get_execute_url` tool with the flow ID and the signer's account ID. Your agent will retrieve the unique URL where the participant can perform the signature.

**Is it possible to download the signed documents?**
Yes! Once a sign flow is completed, you can use the `download_docs` tool to retrieve temporary download links for all documents included in that flow.