How to Use the Basecamp MCP in Vercel AI SDK

Q: How do I authenticate my Basecamp users in a Vercel AI SDK app?

You use the authProvider option in createMCPClient to handle OAuth. This passes the user's token securely to the Vinkius MCP host.

Q: How does the Vercel AI SDK stream Basecamp to-do lists without lag?

The SDK uses streamText to process the JSON output of listtodos as it arrives. Your UI displays the list items one by one instead of waiting for the entire Basecamp payload to download.

Stream live Basecamp project updates and to-do lists directly to your frontend users with the Vercel AI SDK.

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 Vercel AI SDK

Create your Vinkius account to connect Basecamp to Vercel AI 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Campfire Streams in your Vercel AI SDK App

The `list_campfire_lines` tool retrieves real-time chat logs from your Basecamp project rooms. Your Vercel AI SDK application streams these chat messages directly into your React or Next.js UI without making the user wait for a full page reload. By calling `mcpClient.tools()` and passing the output to `streamText`, your interface renders live project chats. This removes the need for polling or custom WebSockets, keeping your team updated instantly.

Render Live Basecamp To-dos in Next.js

The `list_todos` tool reads active tasks from specific lists inside your Basecamp projects. Your Vercel AI SDK frontend renders these tasks as interactive checkboxes the moment the agent finds them. Because this MCP Server runs on Vinkius, you don't write custom API wrappers for your Next.js Edge Functions. You just fetch the list with `list_todolists` and let the agent stream the structured data straight to the user's screen.

Real-time Message Board Feeds

The `list_messages` tool fetches the latest discussion threads from your Basecamp message boards. Your Vercel AI SDK interface displays these updates as they stream in, letting users track project decisions live. You instantiate this MCP connection inside your API route and call `mcpClient.close()` once the message stream finishes. This keeps your serverless functions light and prevents connection leaks on your hosting platform.

Setup guide

Set up Basecamp MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Basecamp tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Basecamp transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

You use the `authProvider` option in `createMCPClient` to handle OAuth. This passes the user's token securely to the Vinkius MCP host.

Yes, this Basecamp MCP Server runs on Vinkius, which exposes a standard HTTP endpoint. Your Vercel AI SDK code connects to it using a standard fetch transport, making it fully compatible with edge runtimes.

The SDK uses `streamText` to process the JSON output of `list_todos` as it arrives. Your UI displays the list items one by one instead of waiting for the entire Basecamp payload to download.

The Vercel AI SDK handles streaming chunks, meaning your users see the initial project structure from `get_project` immediately. The agent continues filling in the details as the data arrives.

Vinkius runs the MCP server inside an isolated V8 sandbox, meaning your chat logs and messages never persist on disk. Every request is ephemeral, and the endpoint token prevents unauthorized access to your account data.

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