How to Use the Joomla (Open-Source CMS) MCP in OpenAI Agents SDK

Q: How do I connect the OpenAI Agents SDK to Joomla (Open-Source CMS)?

You instantiate an MCPServerStreamableHttp client with your Vinkius endpoint URL. Pass that server object into the Agent constructor in the mcpservers list. The SDK automatically discovers all the available tools like listsitearticles.

Q: Can I trace agent actions within my Joomla (Open-Source CMS) site using the OpenAI Agents SDK?

Yes. Every tool call, from listplatformusers to patchcmsarticle, is automatically traced and visualized in the OpenAI platform dashboard. You get a full log of the agent's execution path.

Build production Joomla agents with the OpenAI Agents SDK, featuring built-in guardrails and full execution tracing.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Joomla (Open-Source CMS) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Joomla (Open-Source 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 Joomla (Open-Source CMS) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Create and Edit Content with Guardrails

This MCP server lets your agent create and modify Joomla content. With the OpenAI Agents SDK, every action is a proposal first. When your agent wants to run `create_cms_article`, the SDK can pause and require your code to approve the action before it executes. No more accidental posts. This gives you a human-in-the-loop workflow, but automated. The same logic applies to editing with `patch_cms_article` or removing content with `delete_cms_article`. Your code gets the final say before any changes are made to your live Joomla site, giving you a critical safety layer for production agents.

Coordinate Agents for Complex Site Audits

The SDK is built for creating systems of specialized agents that hand off tasks. For example, a 'scanner' agent can use `list_site_articles` to pull a complete inventory of your content. It can then pass that list to an 'auditor' agent for deeper inspection. The auditor agent can then loop through the list, calling `get_article_details` on each article to check for broken links or outdated information. Every one of these steps is automatically logged in your OpenAI dashboard, so you have a full trace of which agent did what, and why.

Manage Users and Structure via your MCP Server

Go beyond just articles and tags. This toolset gives your agent access to core Joomla management functions. You can build an agent that periodically checks for stale accounts by calling `list_platform_users` and cross-referencing the results with an external system. Your agent can also map out your entire site architecture using `list_global_categories` and `list_site_menus`. This allows you to build sophisticated bots that can suggest—and with your approval, execute—structural changes. This MCP server exposes the core functions you actually need.

Setup guide

Set up Joomla (Open-Source 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 Joomla (Open-Source CMS) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Joomla (Open-Source 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 Joomla (Open-Source 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="Joomla (Open-Source CMS) Agent",
            instructions="You have access to Joomla (Open-Source 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 Joomla. 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 Joomla (Open-Source 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 Joomla (Open-Source CMS) MCP in OpenAI Agents SDK

You instantiate an `MCPServerStreamableHttp` client with your Vinkius endpoint URL. Pass that server object into the `Agent` constructor in the `mcp_servers` list. The SDK automatically discovers all the available tools like `list_site_articles`.

The SDK lets you intercept a tool call before it runs. Your agent decides to call `create_cms_article` with certain parameters, and your code can inspect, approve, or deny that specific action before it ever reaches the Joomla server.

Yes. Every tool call, from `list_platform_users` to `patch_cms_article`, is automatically traced and visualized in the OpenAI platform dashboard. You get a full log of the agent's execution path.

This server handles authentication, infrastructure, and provides a standardized tool interface that the OpenAI SDK understands out of the box. You don't have to write custom wrappers for every API endpoint; just connect the agent and start working.

No. The server is ephemeral and processes data in-transit only. It touches Joomla data like article content, user lists, and tag names, but it doesn't store any of it. All operations are stateless and proxied directly to your Joomla instance.

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