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
- Account connector https://onelifevibe.com/mcp: served there too, but called with no token or identity, so it never returns account data.
- Free connector https://onelifevibe.com/mcp/free: no sign-in, read-only, rate-limited.
- Switches itself on when helpbless.com lists it as an anonymous tool; until then the connectors do not offer it.
Inputs
| Argument | Type | Notes |
|---|---|---|
state | string matching ^[A-Za-z]{2}$ | Two-letter US state code, for example CA. |
income | integer 0-10000000 | Gross household income in US dollars (per month unless period is year). |
period optional | month | year | Whether income is per month (default) or per year. |
size optional | integer 1-20 | People in the household, the applicant included (default 1). |
kids optional | integer 0-19 | Children under 19 in the household. |
under5 optional | boolean | A child under 5 at home. |
school optional | boolean | A child in K-12. |
pregnant optional | boolean | Someone is pregnant or had a baby in the last 6 months. |
senior optional | boolean | Someone is 65 or older. |
disability optional | boolean | Someone has a disability. |
uninsured optional | boolean | Someone has no health insurance. |
medical optional | boolean | Unpaid medical bills. |
energy optional | boolean | Behind on power, heating or cooling bills. |
renter optional | boolean | Renting, or at risk of losing the home. |
working optional | boolean | Someone has wages or self-employment income. |
veteran optional | boolean | Someone served in the US military. |
jobloss optional | boolean | Someone lost a job or hours recently. |
legal optional | boolean | Facing 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
- helpbless_list_my_needs my asks
- helpbless_list_my_gifts gifts I gave
- helpbless_list_saved_needs saved needs
- helpbless_save_need save or unsave a need
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.
Written from the OneLifeVibe tool registry and platform configuration, and checked automatically before publishing. Something wrong? Tell us.