How to Use the Markdown Utilities Engine MCP in OpenAI Agents SDK

Stop letting your agents break documentation. Get exact Markdown tables and TOC anchors directly inside your OpenAI Agents SDK workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Markdown Utilities Engine MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Clean data tables via OpenAI Agents SDK

The `generate_table_from_json` tool formats raw JSON data into clean, compliant Markdown tables during runtime execution. Your agents often fail at spacing and column alignment when outputting raw text, but offloading this to a dedicated tool guarantees perfect formatting every time. You don't have to prompt-engineer your way around pipe characters or broken column widths anymore. Pass the JSON payload directly to this tool within your agent's tool execution block, and let the server output structured Markdown that renders correctly in any parser.

Perfect header anchors with this MCP Server

The `generate_toc` tool processes raw Markdown strings to construct a nested Table of Contents with correct, clickable anchor links. Agents frequently invent non-functional anchors or get confused by special characters in headers, which leads to broken links in your published docs. This tool runs deterministically to parse headers and build the list. By deploying this MCP server alongside your multi-agent system, your documentation agent can hand off raw text and receive a verified, clickable navigation block in milliseconds.

Safe production-grade document generation

Combining `generate_table_from_json` and `generate_toc` with OpenAI's built-in guardrails ensures your production agents never write malformed documents. Since the SDK validates tool inputs before executing them, you get clean formatting without risking raw text injection. You can trace every single table conversion and TOC generation step on your OpenAI dashboard. If an agent tries to pass bad JSON to the MCP server, the system catches it immediately, keeping your automated documentation pipeline safe and reliable.

Setup guide

Set up Markdown Utilities Engine 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 Markdown Utilities Engine tools at runtime.
3

Create your Agent

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

Run the agent

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

Install the SDK first, then use MCPServerStreamableHttp to connect to the Vinkius endpoint. Pass the server instance directly into your Agent constructor using the mcp_servers parameter. The SDK auto-discovers both formatting tools with zero manual configuration.

Yes, you should set cacheToolsList=True in your connection parameters. This prevents the SDK from repeatedly querying the server for tool schemas, which keeps your agent's response times fast and reduces startup latency.

Large language models are probabilistic and frequently mess up complex column alignments or deep header nesting. This engine uses deterministic code to generate your tables and TOCs, ensuring your output never has broken syntax or dead anchor links.

Yes. You can configure a specialized writer agent to pass raw JSON to the table formatter, then have a formatting agent call the TOC generator before finalizing the document. The SDK handles these handoffs while maintaining the tool context.

The Vinkius sandbox processes your raw JSON strings and Markdown headers in an ephemeral, zero-trust environment. No data is stored or logged after the formatting tool finishes rendering your tables and TOCs.

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