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

# BenefitFlow MCP tools and limits

> Every tool the BenefitFlow MCP gives your AI assistant, how to check your connection and usage, and what to do when you hit a limit.

This page lists every tool your AI assistant gets once it's connected to BenefitFlow, plus the usage limits that apply. If you're building an agent or running large batches, start with [Check your connection](#check-your-connection) and [Usage limits](#usage-limits).

Not connected yet? See [Connect your AI assistant](https://docs.benefitflow.com/knowledge-base/connect-your-ai-assistant.md).

## Tools

The tool ID is the name your assistant, or your own code, uses to call it. You'll also see these names in your assistant's permission settings.

| Tool | Tool ID | What it does |
| :- | :- | :- |
| **Search employers** | `search_employers` | Filter employers by size, location, industry, funding type, renewal month, current broker or carrier, retirement plan, and more |
| **Search brokers** | `search_brokers` | Find brokerages by name, size, office locations, and client characteristics |
| **Search contacts** | `search_contacts` | Find people at employers or brokerages by role, title, and location |
| **Get employer** | `get_employer` | Pull a full employer profile: key partners, renewal date, recent signals, Deep Research |
| **List policies** | `list_policies` | Pull an employer's Form 5500 policies by plan year: carrier, premium, covered lives, PEPM, brokers, and commissions |
| **Get broker** | `get_broker` | Pull a broker firm profile: offices, clients, commissions, premiums |
| **Get contact** | `get_contact` | Reveal a contact's email and phone. Uses contact credits, and you confirm before anything is spent |
| **Enrich companies** | `enrich_companies` | Match a list of employer names or domains to BenefitFlow records |
| **Get filter options** | `get_filter_options` | Look up the exact filter values available, like carrier names, industries, and job titles |
| **Search knowledge base** | `search_knowledge_base` | Ask how BenefitFlow features work. Answers come from this help center, with links |
| **Check connection** | `health_check` | Confirm your connection works and see your access, limits, usage, and credit balance |
| **Check usage** | `get_usage` | See how much of each limit and credit balance you have left, and when each one resets |

## Check your connection

Call `health_check` at the start of a session or before a batch run. It tells you:

* Whether MCP access is turned on for your account, and how to fix it if it isn't
* Whether your sign-in has the permissions BenefitFlow needs
* Your usage limits and how many calls you've made today
* Your contact credit balance

`health_check` is free. It doesn't use credits and doesn't count toward your usage limits.

> [!TIP]
>
> Building an agent? Have it call `health_check` first. If the check fails, your agent can stop or reroute before it spends a batch of calls.

## Usage limits

To keep the service fast for everyone, each account has usage limits:

| Limit | What it counts |
| :- | :- |
| **Calls per minute** | Tool calls you make in a minute |
| **Calls per day (you)** | Tool calls you make in a day |
| **Calls per day (your account)** | Tool calls everyone on your account makes in a day |
| **Contacts revealed per day** | Contacts you reveal with `get_contact` in a day |
| **Monthly enrichment** | Employers matched by `enrich_companies` this month |

Limits vary by account. To see yours, call `get_usage`. For each limit it shows the limit, how much you've used, how much is left, and when it resets. `get_usage` is free but counts as a call.

Contact credits are separate from these limits. See [Credits and Exporting](https://docs.benefitflow.com/knowledge-base/credits-and-exporting.md).

## When you hit a limit

Your assistant gets a "too many requests" error instead of results.

1. Call `get_usage` to see which limit you hit and when it resets.
2. Wait until that reset time. Retrying sooner returns the same error.
3. For big jobs, spread the calls out or split the batch across days.

Need higher limits for your team's workload? Email [customerteam@benefit-flow.com](mailto:customerteam@benefit-flow.com) with what you're running and roughly how many calls a day it needs.

> [card] [Connect your AI assistant](https://docs.benefitflow.com/knowledge-base/connect-your-ai-assistant.md)

> [card] [Credits and Exporting](https://docs.benefitflow.com/knowledge-base/credits-and-exporting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.