How to Use the Intercom MCP in OpenAI Agents SDK

Q: How do I connect the Intercom MCP Server to the OpenAI Agents SDK?

Install the SDK with pip install openai-agents and initialize MCPServerStreamableHttp with your Vinkius server URL. Pass this server instance directly into your Agent constructor using the mcpservers argument. The agent automatically discovers all ten tools.

Q: Can I route conversations to specific team members?

Yes. Use listadmins to get the list of active team members and their IDs. Your agent can then assign or tag the thread using these IDs to ensure the right human takes over.

Run enterprise-grade support agents using the OpenAI Agents SDK and an MCP Server to manage your Intercom inbox with strict safety guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Intercom MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safely draft and send replies with OpenAI Agents SDK

Using `reply_to_conversation` and `get_conversation` lets you stop worrying about support bots going off script. Coupling the OpenAI Agents SDK with the Intercom MCP Server keeps things tight. The framework blocks bad outputs before they go live. Configure handoffs between specialized agents to handle complex tickets. If a customer asks a tough technical question, the triage agent hands the thread off to a specialist with zero lag.

Target the right customers using search tools

Finding specific user profiles is simple when your agent uses `search_contacts` to pinpoint leads. The agent pulls their complete profile using `get_contact` without scraping your database. This keeps your sales and support teams aligned. Manual lookups are a waste of time. The agent fetches company associations via `list_companies` and prepares context before a human even opens the ticket.

Sync help center articles to resolve tickets faster

Your agent uses `list_articles` to scan your live help center documentation and extract the exact steps a customer needs. This stops your team from answering the same basic questions over and over. Pairing this documentation with `list_conversations` lets you see if the user has reached out about this issue before. The SDK traces every single API call, giving you complete visibility into what works.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK with `pip install openai-agents` and initialize `MCPServerStreamableHttp` with your Vinkius server URL. Pass this server instance directly into your Agent constructor using the `mcp_servers` argument. The agent automatically discovers all ten tools.

Yes, you can restrict the tools the agent can access. Simply omit `reply_to_conversation` from the agent's allowed tool list, or use the SDK's guardrails to intercept and review drafts before they are sent.

The SDK relies on the underlying connection to handle HTTP requests. When using tools like `list_conversations` or `list_contacts`, set `cacheToolsList=True` to minimize discovery overhead and conserve your API quota.

Yes. Use `list_admins` to get the list of active team members and their IDs. Your agent can then assign or tag the thread using these IDs to ensure the right human takes over.

This MCP Server handles sensitive customer contacts, chat messages, and conversation histories. Vinkius runs the server in an ephemeral, isolated sandbox where credentials never persist, ensuring your support data remains strictly confidential.

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