How to Use the Yousign MCP in Mastra AI

Q: How can I manage document signing processes with Yousign and Mastra AI?

You initiate the process using createsignaturerequest. Within your workflow, you then pass documents via adddocumenttorequest and define signers using addsignertorequest. This forms a complete, traceable sequence.

Q: What information is available when listing requests with Yousign and Mastra AI?

Calling listsignaturerequests gives you a summary of all existing processes. You'll get enough initial data to determine if further action, like cancellation via cancelongoingrequest, is necessary.

Q: Does the MCP Server support contact management for Yousign and Mastra AI?

Yes. For keeping your user base organized, you can call createyousigncontact to add a new entry or use listyousigncontacts to fetch existing records into your workflow state.

Build reliable signing workflows with Mastra AI and Yousign MCP Server.

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 Mastra AI

Create your Vinkius account to connect Yousign to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Signature Request Creation

Use `create_signature_request` to initiate a new document signing process within a multi-step workflow. If the initial call fails, Mastra AI's built-in retries can automatically attempt to create the request again using exponential backoff. This reliability ensures that even if an API call temporarily drops, your critical business logic doesn't halt.

Manage and Update Signers in Workflows

You can define who signs by calling `add_signer_to_request` at a specific point in the workflow. If an admin needs to adjust participants, they can execute this tool call, which Mastra AI handles as part of its state machine. This allows your agent framework to manage complex participant lists that might change over time.

Monitor and Retrieve Audit Trails

A core workflow step is verification. Call `get_audit_trail_link` to grab the evidence file link needed for compliance logging. You can also use `list_signature_requests` to check the overall status of all pending documents. This lets your backend confirm that every necessary action, like getting the audit trail, has been successfully completed before moving to the next step.

Setup guide

Set up Yousign MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Yousign tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "yousign-alternative-mcp-client",
  servers: {
    "yousign-alternative-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Yousign Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Yousign tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Yousign transactions"
);
console.log(result.text);

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 Mastra AI

You initiate the process using `create_signature_request`. Within your workflow, you then pass documents via `add_document_to_request` and define signers using `add_signer_to_request`. This forms a complete, traceable sequence.

Absolutely. If your workflow needs to check the status of an ongoing request (`get_signature_request`) and it fails due to a temporary network issue, Mastra AI's automatic retries will attempt the call again until successful or until configured failure limits are hit.

Calling `list_signature_requests` gives you a summary of all existing processes. You'll get enough initial data to determine if further action, like cancellation via `cancel_ongoing_request`, is necessary.

Yes. For keeping your user base organized, you can call `create_yousign_contact` to add a new entry or use `list_yousign_contacts` to fetch existing records into your workflow state.

This server interacts with signature request metadata, including participant names and document IDs. It's important that any process touching `get_workspace_details` handles account information securely.

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