# NationBuilder MCP for AI Agents AI Agent Connect > NationBuilder is an Connector that lets you manage political campaigns and nonprofit community data through your AI client. It handles supporter signups, donation tracking, and petition monitoring. Instead of jumping between tabs, you can query your database, update records, and pull audience metadata using natural language. It's built for organizers who need to move fast without manual data entry. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_rtBjoK2I8T8FeZouGsb6KjJgZPeBhdt8MlY3iPEX/ai-agent-connect - **Tags:** community-organizing, political-campaigns, advocacy, donor-management, petition-tracking ## Description NationBuilder gives your AI agent direct access to your political or nonprofit database. It handles the heavy lifting of community orchestration so you don't have to keep switching windows to check on your supporters. If you're running a campaign, you can ask your agent to find specific donors, summarize petition engagement, or pull metadata on new signups. It turns your chat interface into a command center for your organization's data. You can manage your audience segments and track fundraising goals in real time. By connecting this Connector through the Vinkius catalog, you bridge the gap between your campaign software and your daily workflow. It's about getting answers immediately. Instead of manually digging through spreadsheets or navigating complex menus to find a supporter's history, you just ask your agent. You can quickly see who joined your nation, what tags they have, and what they've contributed to your cause. It removes the friction of data entry and keeps your focus on your actual goals. You stop being a data entry clerk and start acting like a strategist. This integration ensures that your voter and donor lists are always at your fingertips, allowing for faster response times and more effective community mobilization. ## Tools ### record_donation Add a new financial contribution record to your database. This eliminates the need for manual data entry. ### create_new_signup Add a new person to your nation's supporter list. Use this to quickly register new community members. ### get_api_status Check if your connection to the NationBuilder API is active. Use this to verify your connection is working. ### get_signup_details Get specific information about a person who signed up for your nation. This is useful for quickly reviewing a supporter's profile. ### list_recent_donations See a list of the latest financial contributions to your campaign. Use this to monitor your fundraising progress in real time. ### list_upcoming_events View your nation's calendar to see what's scheduled next. It helps you keep your events organized in one place. ### list_custom_people_lists Browse your curated segments and custom supporter groups. This helps you manage different audience types easily. ### list_nation_petitions See all the active petitions your nation is currently running. Use this to monitor your advocacy efforts. ### list_nation_signups Pull a list of all people who have joined your nation. This is great for checking recent community growth. ### list_nation_sites View the CMS sites associated with your nation. This gives you an overview of your digital presence. ### list_signup_tags See the different tags available for categorizing your supporters. Use this to understand your audience segments. ### find_signup_by_email Search for a specific supporter using their email address. This is the fastest way to find a person's history. ## Prompt Examples **Prompt:** ``` Who signed up from the latest rally? ``` **Response:** ``` I've pulled the latest signups. You have 12 new supporters from the rally, including **Sarah Jenkins** and **Mike Ross**. Would you like to see the tags for any of them? ``` **Prompt:** ``` What's our donation status for this week? ``` **Response:** ``` Here are your recent contributions: | Donor | Amount | Date | | --- | --- | --- | | Jane Doe | $50.00 | Oct 12 | | John Smith | $100.00 | Oct 13 | **Total for the week: $150.00.** ``` **Prompt:** ``` Find the supporter with email jane.doe@example.com. ``` **Response:** ``` Found her! **Jane Doe (ID: 4421)** has been a supporter since 2022. She is tagged as a **high-value donor** and has attended 3 events. ``` ## Capabilities ### Pull supporter profile details Get specific information about a person who signed up for your nation. ### List recent campaign contributions See a list of the latest financial contributions to your campaign. ### View upcoming calendar events View your nation's calendar to see what's scheduled next. ### Browse custom audience lists Browse your curated segments and custom supporter groups. ### Monitor active petitions See all the active petitions your nation is currently running. ### Search for signups by email Search for a specific supporter using their email address. ### Add new supporters to the database Add a new person to your nation's supporter list. ## Use Cases ### Checking donor history during a phone call A campaign manager needs to check a donor's history during a live call. They ask the agent to find a supporter by email. The agent uses `find_signup_by_email` to pull the full profile, showing the donor's history and tags instantly. ### Tracking new signups from a recent rally An organizer wants to see how many people signed up last night. A volunteer lead asks for a count of new signups. The agent uses `list_nation_signups` to provide a list of new supporters, including names and join dates. ### Recording a donation over the phone A fundraiser receives a donation over the phone and needs to log it. They ask the agent to record it, and the agent uses `record_donation` to update the database immediately without manual entry. ### Reviewing the upcoming event schedule A coordinator needs to know the next three events. The agent uses `list_upcoming_events` to show the next three calendar entries with titles and dates, allowing for faster planning. ## Benefits - Get instant summaries of supporter history using `get_signup_details` without digging through nested menus. This lets you quickly understand a supporter's journey and history in seconds. - Track your fundraising progress in real time by calling `list_recent_donations` during live events. You can see exactly how much money is coming in without refreshing your browser. - Keep your calendar organized by pulling upcoming dates with `list_upcoming_events` directly into your chat. It helps you stay on top of your schedule without leaving your workspace. - Organize your audience more effectively by browsing categories with `list_signup_tags`. This makes it much easier to segment your supporters for targeted outreach. - Monitor your advocacy efforts by checking active petitions with `list_nation_petitions`. You can see what's gaining momentum and where you need to focus your energy. - Quickly identify specific supporters by email using `find_signup_by_email` to personalize your outreach. This ensures you have the right info when it matters most. ## How It Works The bottom line is you get a way to query and update your campaign data using only natural language. 1. Subscribe to the NationBuilder MCP on Vinkius. 2. Enter your NationBuilder Access Token (v2) and Nation Slug from your control panel. 3. Ask your AI client to pull signups, check donations, or update records. ## Frequently Asked Questions **Can the NationBuilder MCP help me manage my political campaign?** Yes. It lets your AI agent pull supporter data, check donations, and monitor petitions in real time. **How does NationBuilder help with nonprofit fundraising?** You can use it to record new donations and view recent contributions instantly via your AI client. **Can I use NationBuilder to find specific supporters?** Yes. You can ask your agent to find a person by their email address to see their full profile and history. **Does NationBuilder support petition tracking?** It does. You can list all active petitions and see supporter metadata to help with your advocacy goals. **Can I see my upcoming events with NationBuilder?** Yes. Your agent can pull your nation's calendar to show you what's scheduled next. **Is NationBuilder good for community organizing?** It's built for it. It helps you manage signups, tags, and custom lists to keep your community organized. **Can my AI automatically find the details for a specific signup by their email?** Yes! Use the `search_signups` tool. Provide the email address, and your agent will respond with complete metadata for the profile, including tags and unique ID in seconds. **How do I find my Nation Slug?** The Nation Slug is the unique prefix in your NationBuilder URL (e.g., if you log in at `mynation.nationbuilder.com`, your slug is `mynation`). **Does this support the NationBuilder API v2?** Yes, this Connector is built specifically for the NationBuilder REST API v2, utilizing the modern JSON:API specification for all data interactions.