How to Use the Builder.io (Visual CMS) MCP in OpenAI Agents SDK

Q: How do I connect the Builder.io (Visual CMS) MCP Server to the OpenAI Agents SDK?

Install openai-agents via pip. Initialize the connection using MCPServerStreamableHttp with your Vinkius endpoint URL and pass it to your Agent constructor inside the mcpservers list.

Q: How does caching work with this MCP integration?

Set cacheToolsList=True in your configuration. This prevents the SDK from pulling the tool definitions on every single request, keeping response times low.

Build production-ready OpenAI Agents SDK systems that safely edit your Builder.io visual layout and assets.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Builder.io (Visual CMS) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Builder.io (Visual CMS) 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 Builder.io (Visual CMS) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe content updates via OpenAI Agents SDK

`create_content` and `update_content` tools let your agent modify Builder.io entries directly. OpenAI's SDK runs these mutations within your defined guardrails, keeping layout breaks out of production. You get full tracing on the OpenAI dashboard for every edit. If an agent tries to modify a restricted field, the SDK catches the violation and halts execution.

Direct GraphQL and model queries

`query_graphql` and `admin_graphql` tools expose your entire visual CMS schema to your agents. Instead of writing custom API wrappers, you pass this MCP Server to your agent constructor to auto-discover your schema. The agent inspects your models and retrieves raw data instantly. It handles complex nested queries without manual coding on your part.

Automated asset and HTML management

`upload_asset` and `delete_asset_by_url` tools give your agents control over the media library. Your agent can upload images, check their URLs, or clean up unused assets using simple Python commands. With `get_html`, your agent fetches pre-rendered layouts to inspect the visual output. This lets the agent verify how content looks before finalizing any updates.

Setup guide

Set up Builder.io (Visual CMS) 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 Builder.io (Visual CMS) tools at runtime.
3

Create your Agent

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

Run the agent

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

Install `openai-agents` via pip. Initialize the connection using `MCPServerStreamableHttp` with your Vinkius endpoint URL and pass it to your Agent constructor inside the `mcp_servers` list.

Yes, you control tool access through the SDK's built-in guardrails and agent handoffs. You can route sensitive tasks like `delete_content` to a restricted agent while leaving read-only tools open.

The SDK catches the error and displays the failure in your OpenAI tracing dashboard. Your agent can then read the error message and attempt to correct its parameters.

Set `cacheToolsList=True` in your configuration. This prevents the SDK from pulling the tool definitions on every single request, keeping response times low.

Vinkius runs this MCP Server in an isolated V8 sandbox. Your private API keys and GraphQL queries are never stored or logged, keeping your production CMS data secure.

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