How to Use the NationBuilder MCP in Vercel AI SDK

Q: How do I use the Vercel AI SDK to display NationBuilder signups in a React component?

Your agent calls listnationsignups and passes the tool results to streamText. The AI SDK streams the data directly into your component's state, letting you render the list of supporters as it arrives.

Q: Can I create new supporters in NationBuilder from my Next.js app using the Vercel AI SDK?

Yes. Your agent can invoke the createnewsignup tool. Just pass the person's details from your form, and the MCP Server handles adding them to your NationBuilder database.

Q: What's the best way to handle NationBuilder API connection checks with the Vercel AI SDK?

Before running other operations, have your agent call getapistatus. This tool quickly confirms the connection to NationBuilder is live, preventing errors in your UI.

Stream supporter data from NationBuilder directly into your Next.js app with the Vercel AI SDK. No loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NationBuilder MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Live Supporter Dashboards

Show your campaign staff what's happening right now. Use the Vercel AI SDK to stream supporter activity from NationBuilder straight into your web app's components. Your agent can call `list_recent_donations` and `list_nation_signups`, and the data appears on screen as it arrives. This isn't just about showing data. It's about building interactive tools. Let your team find a specific person with `find_signup_by_email` and see their complete profile from `get_signup_details` populate the UI in real-time. It makes your internal tools feel alive.

Track Events and Petitions Live

Your agent can monitor NationBuilder and feed live updates to your frontend. The `list_upcoming_events` tool lets you build a calendar that updates without a page refresh. New events pop in as they're added by your team. Hook up `list_nation_petitions` to see signature counts climb in real-time. This direct connection makes your campaign feel responsive, showing your team the immediate impact of their work. It's a powerful feedback loop for mobilization.

Interactive Forms with the Vercel AI SDK

Create signup forms that feel instant. When a user submits their info, your agent uses `create_new_signup` and immediately gets back the new record. You can then use `get_signup_details` to confirm their info on the spot, right in the UI. The same goes for donations. After a successful payment, your agent calls `record_donation`. The Vercel AI SDK can stream the confirmation right back to the user, giving them immediate feedback that their contribution was received through this MCP Server.

Setup guide

Set up NationBuilder 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 NationBuilder 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 NationBuilder 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 NationBuilder. 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 NationBuilder 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 NationBuilder MCP in Vercel AI SDK

Your agent calls `list_nation_signups` and passes the tool results to `streamText`. The AI SDK streams the data directly into your component's state, letting you render the list of supporters as it arrives.

Yes. Your agent can invoke the `create_new_signup` tool. Just pass the person's details from your form, and the MCP Server handles adding them to your NationBuilder database.

Before running other operations, have your agent call `get_api_status`. This tool quickly confirms the connection to NationBuilder is live, preventing errors in your UI.

Absolutely. The server is stateless and communicates over HTTP, so it works perfectly with Edge Functions. You can run your AI client close to your users for faster responses.

Your Vinkius token authenticates requests. This MCP server only accesses the NationBuilder data you ask for, like signup details or donation records. All data is passed through ephemeral, sandboxed environments and is never stored by Vinkius.

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