How to Use the Yousign MCP in Pydantic AI

Q: How do I list attached documents with Yousign using Pydantic AI?

To see all files linked to a specific job, use listdocuments and pass in the request ID. This gives you a precise record of everything included in that signature package.

Q: What if I need to check status details with Yousign and Pydantic AI?

The getrequest tool pulls all current details, including the status, for any given request ID. It’s how you track progress through the signing process.

Q: Does Yousign manage signatures using Pydantic AI?

Yes. The createrequest tool lets you spin up a new draft signature job, which is the starting point for any eSignature requirement within your company.

Q: Can I track all my requests with Yousign and Pydantic AI?

You use listrequests to pull a complete list of every signature request in the organization. This is key for auditing multiple jobs simultaneously.

Build reliable agents for signature management with Pydantic AI.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Initiate Signatures using MCP Server

To begin, you call `create_request` to establish a new draft signature request and receive an initial ID. This is the starting point for all your eSignature work. You can then enrich that job by calling `add_signer`, providing both the request ID and the contact information for each participant.

Audit Signatures with Pydantic AI

Need to know what documents were included? The `list_documents` tool shows every file attached to a specific signature request, allowing you to audit the contents. If you need an overview of all existing jobs, `list_requests` pulls a complete list of signature requests in your organization's scope.

Control Workflow via MCP Server

When everything is ready to go, use the `activate_request` tool. This executes the workflow by sending email notifications out to all signers at once. Need to stop a process? The `cancel_request` function permanently cancels an ongoing signature request and allows you to record a reason.

Setup guide

Set up Yousign MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "yousign-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Yousign tools.",
)

result = await agent.run("List recent Yousign transactions")
print(result.output)

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

To see all files linked to a specific job, use `list_documents` and pass in the request ID. This gives you a precise record of everything included in that signature package.

The `get_request` tool pulls all current details, including the status, for any given request ID. It’s how you track progress through the signing process.

Yes. The `create_request` tool lets you spin up a new draft signature job, which is the starting point for any eSignature requirement within your company.

You use `list_requests` to pull a complete list of every signature request in the organization. This is key for auditing multiple jobs simultaneously.

This server manages eSignature request metadata. It handles details like IDs, status updates, and signer contact information across the workflow.

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