How to Use the NationBuilder MCP in Mastra AI

Q: How can I create a conditional workflow in Mastra AI for NationBuilder?

In your Mastra workflow definition, call findsignupbyemail. Then, use an if block to check the result. If a person is found, proceed to recorddonation; if not, your MCP agent can first call createnewsignup.

Q: Can Mastra AI automatically tag new NationBuilder signups based on which petition they signed?

Yes. Your workflow can first use listnationpetitions to get context, then createnewsignup to add the person. In the next step, use that person's ID to apply the correct tag.

Q: Can I require human approval before a donation is recorded in NationBuilder via Mastra AI?

Yes. You can configure your Mastra agent with requireToolApproval. When the workflow gets to the recorddonation step, it will pause and wait for a person to approve the action before proceeding.

Build resilient, multi-step workflows for NationBuilder with Mastra AI. Automate supporter onboarding, donation processing, and data sync.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Failsafe Onboarding Workflows

Mastra AI lets you define a rock-solid process for new supporters. When a new person signs up, trigger a workflow that starts with `create_new_signup`. You can then use conditional logic to check if they came from a specific petition. If the `create_new_signup` call fails because the email exists, Mastra's workflow engine can automatically retry using `find_signup_by_email` to fetch the existing record instead. No manual cleanup needed.

Donation Workflows That Don't Fail

The `record_donation` tool adds a contribution to a supporter's record. With Mastra AI, you can wrap this in a workflow that handles real-world problems. If a payment processor confirms a donation but the `record_donation` call fails, Mastra can retry with exponential backoff. You can also build more complex logic. If a donation is over a certain amount, the workflow can add a specific tag using what it finds from `list_signup_tags` and then notify your fundraising director. It’s automation with guardrails.

Sync Data Across Your Tools with this MCP Server

Use Mastra AI to build a workflow that keeps your other systems updated with NationBuilder data. Schedule a job that runs `list_recent_donations` and syncs the amounts to your accounting software. Or, have it pull a list of attendees from `list_upcoming_events` and add them to an external email list. Because Mastra handles retries, you can trust these sync jobs will complete, even if an API is temporarily down. This MCP Server makes the data available; Mastra makes the process reliable.

Setup guide

Set up NationBuilder MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All NationBuilder tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "nationbuilder-mcp-client",
  servers: {
    "nationbuilder-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "NationBuilder Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to NationBuilder tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent NationBuilder transactions"
);
console.log(result.text);

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 Mastra AI

In your Mastra workflow definition, call `find_signup_by_email`. Then, use an `if` block to check the result. If a person is found, proceed to `record_donation`; if not, your MCP agent can first call `create_new_signup`.

Yes. Your workflow can first use `list_nation_petitions` to get context, then `create_new_signup` to add the person. In the next step, use that person's ID to apply the correct tag.

Mastra's engine will automatically retry the tool call, like `list_recent_donations`, with exponential backoff. You configure the retry policy, so temporary network issues won't break your automation.

Yes. You can configure your Mastra agent with `requireToolApproval`. When the workflow gets to the `record_donation` step, it will pause and wait for a person to approve the action before proceeding.

The server only touches the data required by the tools you call, like petition lists, signup records, and donation information. Each request to your MCP endpoint is authenticated and processed in a zero-trust, ephemeral sandbox. Nothing is logged or stored.

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