How to Use the Yousign MCP in Cursor

Q: How do I get the current quota limits using Yousign and Cursor?

You call getconsumption directly. The agent receives the API consumption data, allowing you to write code that checks quota before attempting a send operation.

Q: What information can I retrieve about an existing request? (Yousign and Cursor)

You use getrequest on a specific ID. This returns the full details and current status, letting your code proceed with accurate context from Yousign.

Q: Can I list documents attached to a request using Yousign and Cursor?

Yes. Running listdocuments against a known request ID provides you with the file metadata needed to process or validate attachments within your script.

Q: Does calling these tools require local setup for my project? (Yousign and Cursor)

No. You configure the connection in .cursor/mcp.json or use a remote URL, so the agent handles the secure connection without you needing to worry about local networking details.

Inject live eSignature data into your code using Cursor. Automate Yousign workflows while you write.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Yousign MCP to Cursor

Create your Vinkius account to connect Yousign to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Yousign with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get real-time status for signature requests.

Stop guessing about API responses. Use `get_request` to pull the current, live status of a specific request ID and inject that string directly into your code block. This means you write working logic that uses actual Yousign data—not mock stubs.

Manage signers programmatically.

Need to add a new signatory mid-write? The `add_signer` tool lets your agent call the API and return the updated request details. You can then use that data to populate a record in your file. This eliminates manual steps and keeps your development flow uninterrupted.

List all active signature workflows.

Building a dashboard? Use `list_requests` to grab the identifiers for every signing request. You can then iterate over that list in your code, fetching status one by one. It’s perfect for writing scripts that audit large numbers of agreements across your Yousign environment.

Setup guide

Set up Yousign MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Yousign MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Yousign transactions." If the MCP tools are loaded correctly, Cursor will call the Yousign tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "yousign-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Yousign. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Yousign now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Yousign MCP in Cursor

You call `get_consumption` directly. The agent receives the API consumption data, allowing you to write code that checks quota before attempting a send operation.

You use `get_request` on a specific ID. This returns the full details and current status, letting your code proceed with accurate context from Yousign.

Yes. Running `list_documents` against a known request ID provides you with the file metadata needed to process or validate attachments within your script.

No. You configure the connection in `.cursor/mcp.json` or use a remote URL, so the agent handles the secure connection without you needing to worry about local networking details.

The core data types are signature request identifiers, signer contact details, and document metadata. Everything revolves around the lifecycle of an electronic signature agreement.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript