Skip to main content

AI connector tools explained

A list of tools supported in NationBuilder's MCP

NationBuilder now lets you connect your nation to an AI assistant. Once connected, the assistant can look things up for you. You can ask how many people signed a petition, or what a supporter's recent activity looks like, and it answers using the real information in your nation.

Here is the part to understand before you start: when the assistant looks something up, that information comes into the chat and stays in the conversation. That is not a reason to avoid it; it is the reason to know what each tool pulls in so you stay in control of your supporters' data.

Most of its tools never touch a supporter’s details. They count, they list, and they organize. Only two tools return a supporter's personal information.

How to read the table

The table below lists every tool the assistant can use, what it does in plain words, and whether it pulls personal data into the chat.

Tool

What it can do

Personal data?

find_person

Looks up a person

Name and email

get_person_engagement

Pulls one person's history

None, but this tool needs to be run right after find_person so you could end up with a person’s email and name from that tool, plus any combination of these: emails opened and when, events attended, logged notes, their donation amounts, and a complete list of tags

count_people

Counts how many people match

None

count_transactions

Counts and totals transactions

None

describe_people_filter_fields

Lists what you can filter people by

None

describe_transaction_filter_fields

Lists what you can filter transactions by

None

find_tag

Finds a tag, and how many people have it

None

find_event

Finds an event, and how many RSVP'd

None

find_mailing

Finds an email blast, and how many opened and clicked

None

find_page

Finds a page, and how many people took action on it

None

find_path

Finds an engagement path, and how many people are on it

None

find_petition

Finds a petition, and how many signed

None

find_list

Finds a list, and how many people are on it

None

find_source

Finds a signup source, and how many people came from it

None

find_broadcaster

Finds a broadcaster, the identity you send from

None

find_automation

Finds an automation, and how many people are in it

None

find_custom_field

Finds a custom field and the options set up for it

None

find_text_blast

Finds an SMS blast, and how many received it

None

find_tracking_code

Finds a tracking code, and how many people came in through it

None

find_election

Finds an election, its dates and offices

None

log_contact

Records a contact you had

None

tag_signups

Tags a group of people

None

Did this answer your question?