# NationBuilder MCP > NationBuilder MCP connects your AI agent directly to political campaign and nonprofit data. Use this MCP to manage communities, track donations, record new signups, and monitor petition engagement through natural conversation. Stop logging into multiple dashboards; get all your supporter data in one chat interface. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** community-organizing, political-campaigns, advocacy, donor-management, petition-tracking ## Description Running a campaign or managing a large non-profit requires tracking dozens of moving parts—from single donations to active petitions. This MCP gives your AI agent full control over the NationBuilder platform, letting you handle community orchestration and fundraising without ever clicking into the main dashboard. Instead, you talk to your agent like it’s a dedicated coordinator who has instant access to all records. Need to know how many supporters signed up last week? Your agent can list recent signups or find specific people by email address instantly. The system tracks everything from financial contributions using tools that record donations and monitor upcoming events. Plus, you can pull detailed profile metadata on any person, check the status of your connection, or even search through custom tags to segment supporters for targeted outreach. When you use Vinkius, you connect once, and this MCP lets your AI client manage complex campaign data—making manual data entry a thing of the past. ## Tools ### record_donation Adds a new donation record to the system for tracking purposes. ### create_new_signup Registers an entirely new person into your community's supporter database. ### get_api_status Checks the current connection status between your AI client and the NationBuilder platform. ### get_signup_details Retrieves full information on a specific person or signup record. ### list_recent_donations Lists the most recent financial contributions made to the campaign. ### list_upcoming_events Retrieves a list of all scheduled calendar events for the community or nation. ### list_custom_people_lists Lists and retrieves predefined, curated groups of supporters or contacts. ### list_nation_petitions Retrieves a list of all currently active petitions for the organization. ### list_nation_signups Lists general information about people or signups within your nation's database. ### list_nation_sites Retrieves a list of the content management system (CMS) sites associated with the nation. ### list_signup_tags Provides an overview of all available tags that can be applied to signups or people. ### find_signup_by_email Searches the database and finds a person's record using their specific email address. ## Prompt Examples **Prompt:** ``` List the last 5 signups in my nation. ``` **Response:** ``` I've retrieved your recent signups. You have 5 new supporters including 'Robert Chen' and 'Alice Miller'. Would you like to see the tags for any of them? ``` **Prompt:** ``` Show me all upcoming events scheduled in my nation. ``` **Response:** ``` I found 3 upcoming events in your nation. "Town Hall Meeting" is scheduled for May 15th with 42 RSVPs, "Volunteer Training" on May 20th has 18 confirmed attendees, and "Community Fundraiser" on June 1st has 89 RSVPs so far. ``` **Prompt:** ``` Find the person with email john.smith@example.com in my database. ``` **Response:** ``` Found a match. John Smith (ID: 8342) is a registered supporter since March 2024. He has the tags "volunteer" and "donor", with 2 recorded donations totaling $150. His current status is "active supporter". ``` ## Capabilities ### Track supporter growth List all current signups or retrieve detailed profile information on any person in the database. ### Manage campaign finances Record new donations and list recent financial contributions to track fundraising goals. ### Monitor advocacy efforts List active petitions and retrieve supporter metadata related to advocacy campaigns. ### Segment and organize contacts Search through available tags or list curated custom people lists to maintain clear contact segments. ### Manage event logistics List upcoming calendar events and manage operational metadata for campaign planning. ## Use Cases ### Following up on a key contact A Campaign Manager needs to know if John Smith, whose email is john.smith@example.com, has donated recently and what his current tags are. The agent uses 'find_signup_by_email' followed by 'get_signup_details' to provide a single summary: status, donation history, and segment tags. ### Accounting for an event An Organizer just finished a town hall meeting. They need to quickly log the $50 contribution from Jane Doe that happened off-platform. The agent uses 'record_donation' immediately, ensuring the financial data is captured before the end of the day. ### Analyzing petition support A Non-profit Organizer wants to see which segment of supporters are most engaged in advocacy efforts. They ask the agent to 'list_nation_petitions' and review the associated supporter metadata to pinpoint key groups. ### Onboarding new volunteers A Campaign Manager signs up a group of new volunteers. Instead of manually creating profiles, they use 'create_new_signup', then immediately use 'list_nation_signups' to confirm the addition and check available tags for immediate categorization. ## Benefits - Automate fundraising tracking. Instead of manually entering donation details, let your agent record donations directly through the chat interface using 'record_donation'. - Get a complete supporter picture instantly. Use 'find_signup_by_email' or 'get_signup_details' to pull full profiles and metadata on any contact without leaving your workflow. - Stay ahead of advocacy goals. Your agent can list active petitions ('list_nation_petitions') and track who is supporting them, giving you real-time mobilization data. - Never lose track of a supporter segment again. Easily search through tags or use 'list_custom_people_lists' to ensure your outreach only goes to the right group. - Simplify operational checks. Use 'list_upcoming_events' to see all scheduled activities and manage metadata for better campaign timing. ## How It Works The bottom line is that you manage complex campaign workflows simply by talking to your AI agent and letting it pull data from NationBuilder. 1. Subscribe to this MCP on Vinkius and enter your NationBuilder Access Token (v2) along with the required Nation Slug. 2. Your AI agent authenticates and establishes a connection to all community and donor data within the platform. 3. You prompt your agent in any compatible client, asking it to perform actions like 'list recent donations' or 'find person by email', which executes the tool call. ## Frequently Asked Questions **Can NationBuilder MCP help me list all my supporters?** Yes. You can use 'list_nation_signups' or 'find_signup_by_email' to retrieve specific details on any person, giving you an overview of your active supporter base. **How do I record a donation using NationBuilder MCP?** You use the 'record_donation' tool. Your agent prompts for the necessary financial details and submits the contribution directly to the platform, logging it instantly. **Does NationBuilder MCP handle event scheduling?** It doesn’t schedule them, but you can use 'list_upcoming_events' to retrieve all scheduled calendar events for your nation. This helps keep your campaign timeline visible in the chat. **Can I find a supporter by their email address with NationBuilder MCP?** Absolutely. The 'find_signup_by_email' tool is designed specifically to search for and retrieve detailed records using an individual’s verified email address. **What if I need to add a completely new person record?** You use the 'create_new_signup' function. This allows your agent to register a brand-new contact into your database, ensuring they are counted from day one.