How to Use the Flowcode MCP in OpenAI Agents SDK

Q: How do I connect Flowcode to OpenAI Agents SDK?

Install the package and initialize MCPServerStreamableHttp with your Vinkius endpoint. Pass the server instance directly to your agent constructor to auto-discover all twelve marketing tools on this MCP Server.

Q: How does OpenAI Agents SDK handle Flowcode image generation?

The agent calls getflowcodeimage to generate the physical QR code image asset. It then uses the built-in tracing to log the generation path and ensure the file is saved correctly.

Q: Can my agents manage multiple marketing campaigns?

Absolutely. Your agent uses listcampaigns to view active marketing initiatives and associates new QR codes with specific folders using listfolders to keep things organized.

Generate dynamic QR codes and monitor scan data directly within your OpenAI Agents SDK production pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flowcode MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Secure QR Generation with OpenAI Agents SDK

The `create_flowcode` tool lets your agent generate dynamic QR codes and save them to specific directories using `list_folders`. With this MCP Server, you can set strict guardrails to prevent your agent from generating rogue codes or dumping files into the wrong folders. Before running any generation tasks, your agent checks existing assets via `list_flowcodes`. This keeps your physical marketing assets organized and prevents duplicate print runs without requiring manual oversight.

Multi-Agent Analytics Routing

The `get_recent_scans` tool pulls raw scan histories so you can hand off heavy analytical work between specialized agents. This MCP setup isolates performance tracking from customer management. Your analysis agent uses `get_audience_summary` and `get_geographic_analytics` to map out campaign performance. You can trace every handoff and tool execution directly inside your OpenAI dashboard to debug bottlenecks.

Automated Lead Capture and Funnel Tracking

The `get_flowpage_contacts` tool pulls contact information submitted by users on your mobile landing pages. By passing this data to your CRM agent, you can automate follow-up emails the second a user scans a physical code. Your agent tracks overall campaign health using `list_conversion_rates` and `get_flowpage_analytics`. It flags low-performing pages early, giving your team enough lead time to update the destination links before printing more physical assets.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the package and initialize `MCPServerStreamableHttp` with your Vinkius endpoint. Pass the server instance directly to your agent constructor to auto-discover all twelve marketing tools on this MCP Server.

Yes, you can configure agent guardrails to restrict tool execution. For instance, you can block the agent from running `create_flowcode` while allowing it to read data using `list_flowcodes`.

The agent calls `get_flowcode_image` to generate the physical QR code image asset. It then uses the built-in tracing to log the generation path and ensure the file is saved correctly.

Absolutely. Your agent uses `list_campaigns` to view active marketing initiatives and associates new QR codes with specific folders using `list_folders` to keep things organized.

We run this integration inside an isolated V8 sandbox that never stores your CRM contacts or scan logs. Your `get_flowpage_contacts` data passes directly to your OpenAI agent over an encrypted transport layer, keeping customer information 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