How to Use the Basecamp MCP in OpenAI Agents SDK

Q: How do I connect the Basecamp MCP Server to my OpenAI Agents SDK pipeline?

Install openai-agents and initialize the Basecamp server using MCPServerStreamableHttp with your Vinkius endpoint. Pass the server instance inside the mcpservers list to your OpenAI Agent constructor to enable auto-discovery.

Q: Can my OpenAI Agents SDK system filter Basecamp tasks by assignee?

Yes, your OpenAI agent uses listpeople to resolve team member IDs and then calls listtodos to parse the Basecamp tasks. The OpenAI SDK's guardrails ensure the agent only queries Basecamp lists it has explicit permission to view.

Q: How does OpenAI Agents SDK handle rate limits when querying Basecamp tools?

Set cacheToolsList=True in your OpenAI Agents SDK configuration to prevent redundant Basecamp schema lookups. The Vinkius sandbox handles the underlying HTTP connection pooling to keep your Basecamp queries within the OpenAI Agents SDK fast.

Q: Can I trace how my agent uses the getproject tool on this MCP Server?

Yes, every call to getproject on this MCP Server is logged directly in your OpenAI developer dashboard. You can inspect the exact payload sent by the OpenAI agent and the raw JSON returned from Basecamp.

Build production-safe OpenAI Agents SDK systems that query Basecamp projects and campfire chats with built-in guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Basecamp MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track Basecamp campfire chats with OpenAI Agents SDK.

The `list_campfire_lines` tool retrieves real-time chat history from your project Campfire directly into your OpenAI Agents SDK pipeline. We use this tool to feed Basecamp conversations into specialized OpenAI agents, letting them parse raw chat logs for action items without manual copying. By pairing this tool with OpenAI's native validation guardrails, your agent checks the returned Basecamp chat lines for sensitive data before passing them to the next agent in your pipeline. You get clean, filtered Basecamp chat data without worrying about raw logs leaking into downstream OpenAI prompts.

Map project to-dos using this MCP Server.

The `list_todos` and `list_todolists` tools expose your active Basecamp task lists to your OpenAI Agents SDK system. Your OpenAI agent calls these tools to inspect what needs to be done, matching Basecamp tasks against team member workloads returned by `list_people`. Because the OpenAI Agents SDK supports full tracing on its dashboard, you can monitor exactly when and why an agent queried a specific Basecamp list. If an agent tries to modify a Basecamp task priority, the OpenAI Agents SDK's built-in execution constraints validate the action before it hits your live Basecamp account.

Inspect message boards using specialized OpenAI agents.

The `list_messages` tool pulls active message board threads from your Basecamp projects so your OpenAI agent can extract project updates. This tool allows a dedicated board-reading OpenAI agent to summarize long threads and hand off specific tasks to another agent in the OpenAI Agents SDK. This multi-agent handoff happens in memory, keeping your Basecamp communication loop tight inside the OpenAI framework. The OpenAI agent reads the Basecamp board, spots a blocker, and immediately triggers a lookup via `get_project` to find the owner.

Setup guide

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

Create your Agent

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

Run the agent

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

Install `openai-agents` and initialize the Basecamp server using `MCPServerStreamableHttp` with your Vinkius endpoint. Pass the server instance inside the `mcp_servers` list to your OpenAI Agent constructor to enable auto-discovery.

Yes, your OpenAI agent uses `list_people` to resolve team member IDs and then calls `list_todos` to parse the Basecamp tasks. The OpenAI SDK's guardrails ensure the agent only queries Basecamp lists it has explicit permission to view.

Set `cacheToolsList=True` in your OpenAI Agents SDK configuration to prevent redundant Basecamp schema lookups. The Vinkius sandbox handles the underlying HTTP connection pooling to keep your Basecamp queries within the OpenAI Agents SDK fast.

Yes, every call to `get_project` on this MCP Server is logged directly in your OpenAI developer dashboard. You can inspect the exact payload sent by the OpenAI agent and the raw JSON returned from Basecamp.

Your Basecamp credentials and project metadata used by the OpenAI Agents SDK are isolated within Vinkius's ephemeral V8 sandboxes. The OpenAI Agents SDK communicates with Vinkius over an encrypted, single-token HTTPS connection, meaning your actual Basecamp API keys never touch the local runtime.

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