Skip to main content
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 and Usage limits. Not connected yet? See Connect your AI assistant.

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.

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

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 with what you’re running and roughly how many calls a day it needs.

Connect your AI assistant

Credits and Exporting

Last modified on November 16, 2026