givebutter_who_am_i
Returns a snapshot of the account the connection is using, so your assistant can confirm context before answering. Typically called once at the start of a conversation.integer
The account ID.
string
The account name.
string
The account’s timezone, used to interpret date ranges.
string
When the account was created.
givebutter_help_center
Searches Givebutter’s help center so your assistant can answer how-to questions about the product.string
required
Either
search to find articles, or get to retrieve the full text of one article.string
The search terms, when
action is search.string
The article ID to retrieve, when
action is get.integer
default:"10"
Maximum number of articles to return for a search (up to 25).
givebutter_load_entity_context
Returns the fields available for a given type of data (for example,contacts or transactions), along with how each field can be filtered, grouped, and aggregated. Your assistant calls this before running a query so it knows what’s possible.
string
required
The type of data to inspect. See What you can query for the
full list.
array
Optional. Specific fields to expand into full detail (operators, metrics, and grouping options).
Omit it to get a lightweight index of every field.
givebutter_query
Runs a query against one type of data, with optional filters, sorting, and aggregates. This is the tool that answers most data questions.string
required
The type of data to query, such as
transactions or contacts.array
required
The conditions to match, such as a date range or an amount threshold.
object
Optional. Totals, averages, counts, and groupings (for example, sum of donations by month).
array
Optional. The specific fields to return for each row.
array
Optional. How to order the results.
integer
default:"25"
How many rows to return (up to 100). Set to
0 to return only aggregate totals.integer
Optional. Used to page through large result sets.
All monetary values are expressed in US dollars, both in your questions and in the results.
You never need to convert to cents.