Assistant tool

helpbless_benefits_check

Screens a US household against 20 benefit programs using state, income and household size, then says what each result gives and where to apply.

Updated November 17, 2026

Website
HelpBLESS · helpbless.com
Class
Read · no account needed
Returns
state, household_size, monthly_income_usd, percent_of_poverty_line, likely, worth_checking, programs[]: name, category, status, why, gives, up_to, apply; page, checked, note

A two-minute screen of 20 US programs a household may qualify for (no account needed): Medicaid, SNAP, WIC, LIHEAP, Lifeline, charity care, the EITC and more, using current poverty guidelines. Each result says why, what it gives, and where to apply. Pass the state, income and household size; the yes/no questions sharpen the answer.

Where you can call it

Inputs

ArgumentTypeNotes
statestring matching ^[A-Za-z]{2}$Two-letter US state code, for example CA.
incomeinteger 0-10000000Gross household income in US dollars (per month unless period is year).
period optionalmonth | yearWhether income is per month (default) or per year.
size optionalinteger 1-20People in the household, the applicant included (default 1).
kids optionalinteger 0-19Children under 19 in the household.
under5 optionalbooleanA child under 5 at home.
school optionalbooleanA child in K-12.
pregnant optionalbooleanSomeone is pregnant or had a baby in the last 6 months.
senior optionalbooleanSomeone is 65 or older.
disability optionalbooleanSomeone has a disability.
uninsured optionalbooleanSomeone has no health insurance.
medical optionalbooleanUnpaid medical bills.
energy optionalbooleanBehind on power, heating or cooling bills.
renter optionalbooleanRenting, or at risk of losing the home.
working optionalbooleanSomeone has wages or self-employment income.
veteran optionalbooleanSomeone served in the US military.
jobloss optionalbooleanSomeone lost a job or hours recently.
legal optionalbooleanFacing eviction, debt collection, custody or another legal problem.

Example request

POST https://onelifevibe.com/mcp/free

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "helpbless_benefits_check",
    "arguments": {
      "state": "<state>",
      "income": 0
    }
  }
}

Other HelpBLESS tools

What it does

helpbless_benefits_check is a read tool on HelpBLESS (helpbless.com). Read means it changes nothing: it takes a household's numbers, runs a screen against 20 US programs and reports what comes up. No account is needed, and the tool never touches account data.

The screen takes about two minutes and uses current poverty guidelines. The program set includes Medicaid, SNAP, WIC, LIHEAP, Lifeline, charity care and the EITC, along with the rest of the 20. Every program that comes back carries a reason it matched, what it gives and where to apply.

When an assistant should call it

Call it when someone describes a money squeeze rather than a single bill: short on groceries, no health coverage, behind on power or heating, a tax return that may miss the EITC. It also fits the broad question of what a family might qualify for, as long as you have a state, an income and a household size.

Run it before any sign-in. The tool needs no account, so it works as an early step in a conversation, and the answer tells you whether a follow-up on HelpBLESS is worth the person's time.

Hold off when the person wants a decision made for them, or wants legal help with an eviction, a debt collector or a custody case. The legal input sharpens the screen. It does not give advice.

Inputs and an example call

state and income are required. state is a two-letter US state code matching ^[A-Za-z]{2}$, for example CA. income is a whole number from 0 to 10000000: gross household income in US dollars, per month unless you set period to year.

The optional ones are period (month or year, month by default), size (1 to 20 people, the applicant included, 1 by default) and kids (0 to 19 children under 19). The rest are yes/no: under5, school, pregnant, senior, disability, uninsured, medical, energy, renter, working, veteran, jobloss, legal. Send only what you actually know, since each true flag sharpens the result.

A fuller call to the free connector at https://onelifevibe.com/mcp/free: method tools/call, params name helpbless_benefits_check, arguments {"state":"CA","income":2400,"size":3,"kids":2,"under5":true,"renter":true,"energy":true}. The minimum is {"state":"CA","income":0}.

What comes back

The response opens with the figures it used: state, household_size, monthly_income_usd and percent_of_poverty_line. Then two lists. likely holds the programs the screen puts in reach on those numbers. worth_checking holds the ones where another answer could move them either way, so treat those as a second look rather than a yes.

programs[] carries the detail. Each entry has name, category, status, why, gives, up_to and apply. why is the reason it matched, gives is what the program provides, up_to is the program's stated ceiling, and apply is where to send the person, which is the field most people act on.

The response also includes page, checked and note. Reach for checked when someone asks how current the screen is, and read note for anything the tool wants to flag about the run.

Errors, limits and safety

The tool is read-only and idempotent: the same arguments give you the same screen. It returns no account data on the account connector at https://onelifevibe.com/mcp, because it is called there with no token or identity. The free connector at https://onelifevibe.com/mcp/free needs no sign-in, is read-only and is rate-limited, so back off and retry if you hit a limit.

Bad input comes back as an error, not a guess. state must be two letters, income must sit between 0 and 10000000, size between 1 and 20, kids between 0 and 19. When a call fails on the arguments, correct the value and send it again instead of filling the gap with an assumption.

One thing to check before wiring it up. The tool switches itself on when helpbless.com lists it as an anonymous tool. Until then the connectors do not offer it, and a client reporting an unknown tool is telling you exactly that.

Questions

Does helpbless_benefits_check need a sign-in?

No. The tool needs no account, and the free connector at https://onelifevibe.com/mcp/free takes calls without sign-in. On the account connector it runs with no token or identity, so it never returns account data.

Is income monthly or yearly?

Monthly by default, given as gross US dollars. Set period to year when the person gives you an annual figure, and the response still reports monthly_income_usd and percent_of_poverty_line.

Why is helpbless_benefits_check missing from my MCP client's tool list?

It switches itself on when helpbless.com lists it as an anonymous tool. Until then the connectors do not offer it. Try the free connector at https://onelifevibe.com/mcp/free once it appears there.

Build with it. Connect an assistant to https://onelifevibe.com/mcp, or get a free Sandbox key for the Platform API.

Get a free key Connector guide

Written from the OneLifeVibe tool registry and platform configuration, and checked automatically before publishing. Something wrong? Tell us.