How to Use the Sensible MCP in OpenAI Agents SDK

Q: Can Sensible help my OpenAI Agents SDK process documents in bulk?

Yes, you can use extractfromurl to queue multiple files for processing. Your agent can then poll for results or wait for completion.

Turn messy PDFs into structured JSON directly within your OpenAI Agents SDK production pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Sensible MCP to OpenAI Agents SDK

Create your Vinkius account to connect Sensible to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Sensible with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automated Document Parsing

Stop writing brittle regex for every new document layout. This MCP Server lets your agents use `extract_sync` to process files and return clean data objects immediately. Your production agent system handles the heavy lifting by passing document bytes directly to the parser. It keeps your logic inside the agent loop without needing extra middleware.

Configuration Lifecycle Management

Maintain your extraction accuracy by managing schemas with `create_configuration` and `update_configuration`. You can version your parsing logic as your document types evolve over time. This ensures your agent always targets the right fields. Use `list_configuration_versions` to track changes and keep your agent's data ingestion stable.

Batch Data Export

Aggregate large volumes of extracted data into usable formats using `generate_csv` or `generate_excel`. This avoids manual file handling after your agent finishes its run. Your agent can trigger these exports once a batch of documents is processed. It saves time by moving data straight from your pipeline to your storage layer.

Setup guide

Set up Sensible 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 Sensible tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Sensible 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="Sensible Agent",
            instructions="You have access to Sensible 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 Sensible. 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 Sensible 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 Sensible MCP in OpenAI Agents SDK

You handle authentication via a single endpoint token managed by the Vinkius platform. This keeps your credentials out of your application code.

Yes, you can use `extract_from_url` to queue multiple files for processing. Your agent can then poll for results or wait for completion.

Absolutely. Since the tools return structured JSON, you can wrap them in your agent's try-catch blocks to handle failed extractions gracefully.

It handles PDFs, images, and standard office documents. You can define custom schemas for any layout using the configuration tools.

Sensible processes your data in an ephemeral sandbox. Once the extraction completes, the document buffer is cleared to protect your sensitive information.

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