How to Use the DocuSeal MCP in OpenAI Agents SDK

Q: How do I add the DocuSeal MCP Server to my OpenAI Agents SDK pipeline?

Instantiate MCPServerStreamableHttp with your Vinkius endpoint. Pass it inside the mcpservers list when initializing your agent, then turn on cacheToolsList=True to avoid redundant API discovery calls during execution.

Q: What happens if an OpenAI Agents SDK agent fails to find a DocuSeal template?

The agent will execute listtemplates to search for alternatives. If it still can't find the target, it can fall back to createtemplate to generate a new template from HTML directly.

Q: Is there a way to cancel pending signature requests?

Your agent can call deletesubmission over this MCP connection to cancel any outstanding request. It can also clean up outdated layouts by calling deletetemplate when they are no longer needed.

Automate document signing workflows with OpenAI Agents SDK to safely generate templates, send requests, and track signers.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DocuSeal MCP to OpenAI Agents SDK

Create your Vinkius account to connect DocuSeal to OpenAI Agents SDK 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 DocuSeal with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe template generation with OpenAI Agents SDK

Your Python agent can build contracts on the fly. By connecting this DocuSeal MCP Server, the agent converts HTML layouts into signing templates using `create_template` and updates them with `update_template` while OpenAI's tracing dashboard records every payload. If the agent tries to alter a locked template, your built-in guardrails stop the action before it hits the API. You get complete visibility into template generation without risking manual mistakes.

Autonomous signature dispatch and tracking

Let your specialized agents coordinate signature collection. One agent initiates the request via `create_submission` and hands off the task to a tracking agent that polls `get_submission` to monitor progress. This handoff pattern keeps your main agent execution loop clean. When the document is fully signed, the tracking agent uses `get_submission_documents` to fetch the final PDF download links.

Signer profile management with guardrails

Keep your signer records accurate without writing custom validation code. Your agent uses `update_submitter` to pre-fill form fields and `get_submitter` to read current signer details. This MCP Server ensures your agent only updates authorized fields, preventing unauthorized changes to signer information. You get secure, automated data entry with zero extra middleware.

Setup guide

Set up DocuSeal MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all DocuSeal tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives DocuSeal tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate DocuSeal tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="DocuSeal Agent",
            instructions="You have access to DocuSeal tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 DocuSeal. 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 DocuSeal 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 DocuSeal MCP in OpenAI Agents SDK

Instantiate `MCPServerStreamableHttp` with your Vinkius endpoint. Pass it inside the `mcp_servers` list when initializing your agent, then turn on `cacheToolsList=True` to avoid redundant API discovery calls during execution.

Yes, you can separate concerns between different agents. For example, one agent can use `create_submission` to send the document, while a secondary background agent uses `get_submission` to track completion.

The agent will execute `list_templates` to search for alternatives. If it still can't find the target, it can fall back to `create_template` to generate a new template from HTML directly.

Your agent can call `delete_submission` over this MCP connection to cancel any outstanding request. It can also clean up outdated layouts by calling `delete_template` when they are no longer needed.

All signer metadata and signed PDF files remain isolated within your Vinkius sandbox. Your OpenAI agent only accesses these details during active tool execution, meaning your sensitive contract data is never stored on external third-party servers.

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