How to Use the Ugosign MCP in Pydantic AI

Q: Can I list all documents using both Ugosign and Pydantic AI?

Yes, your agent calls listdocuments. Because of the Pydantic layer, even a simple list is guaranteed to be in a predictable, structured format.

Q: If my agent fails, how does Ugosign help using Pydantic AI?

The moment getsignaturerequest returns data that doesn't match your defined schema, the agent halts with a validation error. This prevents silent failures and keeps you honest about the state of the signing process.

Ensure correct legal signing workflows using Pydantic AI's type safety.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ugosign MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Signatures via MCP Server

The `create_signature_request` tool lets your agent start a new signature request. You pass all inputs—like recipient emails or the required dates—as a JSON string, which Pydantic validates before execution. After submission, use `get_signature_request`. This retrieves status details and ensures that the state data returned by the MCP Server matches your expected schema. No hallucinated fields here.

List Documents with Pydantic AI

`list_documents` provides a list of all available files, which is validated against a model structure when received. This gives your agent the necessary scope to work within. To get specific details, call `get_document`. Since every response must conform to a Pydantic model, you can trust that the returned metadata—like file size or ID—is structured correctly.

Verify Organization Context in Pydantic AI

`get_organization` pulls core organizational data. This is crucial for compliance and makes sure your agent knows exactly who is involved in the signing process. Running `get_organization` validates the source context before you build a request using `create_signature_request`. If the API returns garbage, Pydantic fails loudly—you'll know immediately.

Setup guide

Set up Ugosign 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": {
        "ugosign-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Ugosign 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 Ugosign. 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 Ugosign 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 Ugosign MCP in Pydantic AI

You pass all tool outputs through a Pydantic validation layer. When your agent calls `get_signature_request`, the returned status data is immediately checked against your model, guaranteeing correctness.

The server manages signature request statuses and organizational details. The type safety ensures that any changes to `signature requests` or organization metadata are correctly modeled and handled.

Yes, your agent calls `list_documents`. Because of the Pydantic layer, even a simple list is guaranteed to be in a predictable, structured format.

The moment `get_signature_request` returns data that doesn't match your defined schema, the agent halts with a validation error. This prevents silent failures and keeps you honest about the state of the signing process.

The server handles document management metadata, including file IDs and basic document details. The type safety guarantees that you only work with structured references to this data, never raw content.

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