> ## Documentation Index
> Fetch the complete documentation index at: https://docs.givebutter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Available Tools

> A reference for the tools the Givebutter connection exposes to your AI assistant.

When you connect an AI assistant to Givebutter, it gains access to a small set of read-only tools. You don't call these directly. You ask questions in plain language, and your assistant decides which tools to use to answer them. This page documents what each tool does so you understand what's happening behind the scenes.

All tools are **read-only**. They can never modify your account.

| Tool                             | What it does                                                            |
| -------------------------------- | ----------------------------------------------------------------------- |
| `givebutter_who_am_i`            | Confirms which Givebutter account the connection is scoped to.          |
| `givebutter_help_center`         | Searches Givebutter's help center for how-to answers.                   |
| `givebutter_load_entity_context` | Looks up which fields are available for a type of data before querying. |
| `givebutter_query`               | Runs a filtered, optionally aggregated query against your data.         |

## 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.

<ResponseField name="id" type="integer">
  The account ID.
</ResponseField>

<ResponseField name="name" type="string">
  The account name.
</ResponseField>

<ResponseField name="timezone" type="string">
  The account's timezone, used to interpret date ranges.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the account was created.
</ResponseField>

## givebutter\_help\_center

Searches Givebutter's [help center](https://help.givebutter.com) so your assistant can answer how-to questions about the product.

<ParamField path="action" type="string" required>
  Either `search` to find articles, or `get` to retrieve the full text of one article.
</ParamField>

<ParamField path="query" type="string">
  The search terms, when `action` is `search`.
</ParamField>

<ParamField path="id" type="string">
  The article ID to retrieve, when `action` is `get`.
</ParamField>

<ParamField path="limit" type="integer" default="10">
  Maximum number of articles to return for a search (up to 25).
</ParamField>

## 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.

<ParamField path="entity" type="string" required>
  The type of data to inspect. See [What you can query](/ai-connections/querying-your-data) for the
  full list.
</ParamField>

<ParamField path="field_keys" type="array">
  Optional. Specific fields to expand into full detail (operators, metrics, and grouping options).
  Omit it to get a lightweight index of every field.
</ParamField>

## 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.

<ParamField path="entity" type="string" required>
  The type of data to query, such as `transactions` or `contacts`.
</ParamField>

<ParamField path="filters" type="array" required>
  The conditions to match, such as a date range or an amount threshold.
</ParamField>

<ParamField path="aggregates" type="object">
  Optional. Totals, averages, counts, and groupings (for example, sum of donations by month).
</ParamField>

<ParamField path="fields" type="array">
  Optional. The specific fields to return for each row.
</ParamField>

<ParamField path="sort" type="array">
  Optional. How to order the results.
</ParamField>

<ParamField path="limit" type="integer" default="25">
  How many rows to return (up to 100). Set to `0` to return only aggregate totals.
</ParamField>

<ParamField path="offset" type="integer">
  Optional. Used to page through large result sets.
</ParamField>

<Note>
  All monetary values are expressed in **US dollars**, both in your questions and in the results.
  You never need to convert to cents.
</Note>

See [What you can query](/ai-connections/querying-your-data) for the data types, filters, and aggregates these tools support.