How to Use the NationBuilder MCP in LlamaIndex

Q: Can I run semantic searches on my custom donor lists?

Yes, you can. Feed the output of listcustompeoplelists into your vector index to let your agent search through curated groups of supporters.

Index your campaign records directly into LlamaIndex vector stores to ground your queries in live supporter data.

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 LlamaIndex

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Index live signups into LlamaIndex RAG

The `list_nation_signups` tool exports your active supporter database in structured chunks. Your LlamaIndex pipeline ingests this raw data over the MCP Server to build a semantic index of your community base. Instead of running slow SQL queries, your agent searches this index to find patterns in supporter signups. You get instant answers grounded in real-time campaign registrations.

Analyze donation trends via vector search

The `list_recent_donations` tool pulls the latest financial contributions recorded on your platform. LlamaIndex indexes these transactions to track average gift sizes and campaign momentum. When your agent queries the index, it matches donation amounts with regional signup spikes. This lets you see which local rallies are driving the most financial support.

Map petition signatures to active lists

The `list_nation_petitions` tool retrieves all active advocacy campaigns running on your site. Your agent matches this list against `list_custom_people_lists` to see which cohorts are signing which petitions. This mapping helps you identify which issues resonate with specific segments of your donor file. You can then target your next email blast with high precision.

Setup guide

Set up NationBuilder MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all NationBuilder MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to NationBuilder tools.",
)
response = await agent.run("List recent NationBuilder data")

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 LlamaIndex

Use the BasicMCPClient to expose the tools to your indexer. LlamaIndex calls `get_signup_details` to retrieve supporter histories and converts the text into searchable vector embeddings.

Yes, because the agent relies on real-time outputs from tools like `list_signup_tags` to ground its answers. It won't invent tags that do not exist in your database.

The server acts as a direct bridge, translating API payloads into clean documents. This allows LlamaIndex to parse lists from `list_nation_sites` without manual data cleanup.

Yes, you can. Feed the output of `list_custom_people_lists` into your vector index to let your agent search through curated groups of supporters.

All financial transactions and signup details are processed through memory-only V8 isolates via our MCP Server. Your API keys are encrypted, ensuring donor data never touches public LLM training sets.

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