grant-finder

Eligibility-navigator: given a household situation (income, size, filing status), return which federal/state benefits & credits the person LIKELY qualifies for but may be missing — each with a confidence tier (LIKELY/VERIFY/UNLIKELY), the exact governing rule cited inline, the verify-date, and the administering body to claim it FREE. Never a guarantee; never files for you.

{
  "type": "object",
  "properties": {
    "householdIncome": {
      "type": "number",
      "description": "Annual household income (USD)."
    },
    "householdSize": {
      "type": "number",
      "description": "People in household."
    },
    "filingStatus": {
      "type": "string",
      "enum": [
        "single",
        "mfj",
        "married"
      ],
      "description": "Tax filing status."
    },
    "hasAffordableEmployerCoverage": {
      "type": "boolean"
    },
    "onQualifyingProgram": {
      "type": "boolean",
      "description": "Already on SNAP/Medicaid/SSI/etc."
    },
    "retirementContribution": {
      "type": "number",
      "description": "IRA/401k contributed this year (USD)."
    }
  },
  "required": [
    "householdIncome",
    "householdSize"
  ]
}

Value a collector's item from live retail + sold comps (DropWatch price-history) and return a confidence-tiered estimate with the comp shops and scrape date. Free preview of the value; the full appraisal+eligibility prep payload is the premium tool grail_appraise.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Item name, be specific (set + type)."
    },
    "niche": {
      "type": "string",
      "enum": [
        "tcg",
        "lego",
        "funko",
        "vinyl",
        "keebs",
        "aqua"
      ]
    }
  },
  "required": [
    "query"
  ]
}

PREMIUM. Full GrailQualify appraisal + eligibility-prep payload: live valuation with all comps & scrape date, scheduled-insurance under-coverage gap, grading worth-it call — each rule-cited with authority hand-off. Pay-per-call via x402 (USDC on Base).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "niche": {
      "type": "string",
      "enum": [
        "tcg",
        "lego",
        "funko",
        "vinyl",
        "keebs",
        "aqua"
      ]
    },
    "perItemSpecialLimit": {
      "type": "number",
      "description": "Your home-policy per-item valuables limit (USD)."
    }
  },
  "required": [
    "query"
  ]
}

Detect federal tax credits a household LIKELY qualifies for but commonly never claims — EITC (26 USC 32), Saver's Credit (25B), education AOTC/LLC (25A), Child & Dependent Care (21), and home energy (25C/25D) — each confidence-tiered with the exact IRS pub cited and the FREE IRS Free File / VITA hand-off. Detection & explanation only; never files a return.

{
  "type": "object",
  "properties": {
    "householdIncome": {
      "type": "number",
      "description": "AGI (USD)."
    },
    "householdSize": {
      "type": "number"
    },
    "filingStatus": {
      "type": "string",
      "enum": [
        "single",
        "hoh",
        "head",
        "mfj",
        "married"
      ]
    },
    "dependents": {
      "type": "number"
    },
    "dependentsUnder13": {
      "type": "number"
    },
    "earnedIncome": {
      "type": "number"
    },
    "investmentIncome": {
      "type": "number"
    },
    "retirementContribution": {
      "type": "number"
    },
    "hasEducationExpenses": {
      "type": "boolean"
    },
    "paidForChildcare": {
      "type": "boolean"
    },
    "childcareCost": {
      "type": "number"
    },
    "madeEnergyImprovement": {
      "type": "boolean"
    },
    "energyKind": {
      "type": "string",
      "description": "solar/battery/heatpump/insulation/etc."
    },
    "energySpend": {
      "type": "number"
    }
  },
  "required": [
    "householdIncome",
    "householdSize"
  ]
}

B2B (RESPA-safe SaaS): given a buyer's 8 fields, return the down-payment-assistance & loan programs (HFA DPA, FHA, VA, USDA, MCC) the buyer likely PASSes, sequenced in apply-order, each program administered by the HFA/approved lender. Flat-fee tool; no per-referral kickback, no lender steering.

{
  "type": "object",
  "properties": {
    "firstTimeBuyer": {
      "type": "boolean"
    },
    "state": {
      "type": "string"
    },
    "householdIncome": {
      "type": "number"
    },
    "householdSize": {
      "type": "number"
    },
    "purchasePrice": {
      "type": "number"
    },
    "creditScore": {
      "type": "number"
    },
    "propertyType": {
      "type": "string",
      "enum": [
        "single",
        "condo",
        "manufactured"
      ]
    },
    "militaryOrVeteran": {
      "type": "boolean"
    }
  },
  "required": [
    "householdIncome",
    "creditScore"
  ]
}

PREMIUM. The reversal mechanic: one life-event trigger (new-baby / bought-a-house / lost-a-job / moved-states / started-a-business) fans out across ALL relevant spine verticals (benefits, missed credits, student-loan relief, DPA) and returns every finding at once — each rule-cited with a free authority hand-off. Pay-per-call via x402 (USDC on Base).

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "enum": [
        "new-baby",
        "bought-a-house",
        "lost-a-job",
        "moved-states",
        "started-a-business"
      ]
    },
    "householdIncome": {
      "type": "number"
    },
    "householdSize": {
      "type": "number"
    },
    "filingStatus": {
      "type": "string"
    },
    "dependents": {
      "type": "number"
    },
    "hasFederalStudentLoans": {
      "type": "boolean"
    },
    "employerType": {
      "type": "string"
    },
    "firstTimeBuyer": {
      "type": "boolean"
    },
    "creditScore": {
      "type": "number"
    }
  },
  "required": [
    "event",
    "householdIncome",
    "householdSize"
  ]
}

Detect which U.S. visa categories likely fit a person's situation (O-1 extraordinary ability, EB-2 NIW, H-1B, family-based, EB-5), each with the governing statute (INA / 8 CFR) cited and a confidence tier. INFORMATION ONLY — not legal advice; every finding hands off to a licensed immigration attorney. Never files a petition.

{
  "type": "object",
  "properties": {
    "fieldOfExtraordinaryAbility": {
      "type": "string"
    },
    "majorInternationalAward": {
      "type": "boolean"
    },
    "o1CriteriaMet": {
      "type": "number",
      "description": "How many of the 8 O-1 criteria you meet."
    },
    "advancedDegree": {
      "type": "boolean"
    },
    "bachelorsOrHigher": {
      "type": "boolean"
    },
    "yearsProgressiveExperience": {
      "type": "number"
    },
    "exceptionalAbility": {
      "type": "boolean"
    },
    "nationalInterestEndeavor": {
      "type": "string",
      "description": "Describe your endeavor of national importance (EB-2 NIW)."
    },
    "hasUsEmployerSponsor": {
      "type": "boolean"
    },
    "usRelativeRelationship": {
      "type": "string",
      "description": "e.g. spouse, parent, sibling."
    },
    "usRelativeStatus": {
      "type": "string",
      "enum": [
        "citizen",
        "lpr"
      ]
    },
    "investableCapitalUSD": {
      "type": "number"
    }
  }
}

Detect eligibility for a second citizenship by ancestry (Italy / Ireland / Poland / Germany), citing each country's descent rule + generational limit + the cut-off that most often breaks a claim. INFORMATION + DOCUMENT-CHECKLIST ONLY — recognition is decided by the foreign government; hands off to the consulate / a citizenship attorney.

{
  "type": "object",
  "properties": {
    "ancestryCountry": {
      "type": "string",
      "enum": [
        "italy",
        "ireland",
        "poland",
        "germany"
      ]
    },
    "nearestQualifyingAncestor": {
      "type": "string",
      "enum": [
        "parent",
        "grandparent",
        "great-grandparent"
      ]
    },
    "ancestorEmigratedYear": {
      "type": "number"
    },
    "ancestorNaturalizedYear": {
      "type": "string",
      "description": "Year ancestor naturalized abroad, or 'never'."
    },
    "bornBeforeAncestorNaturalized": {
      "type": "boolean"
    },
    "lineThroughFemaleBefore1948": {
      "type": "boolean",
      "description": "Italy 1948-rule: line passes through a woman before 1948."
    },
    "parentWasOnForeignBirthsRegister": {
      "type": "boolean",
      "description": "Ireland great-grandparent line."
    },
    "ancestorPersecuted1933to1945": {
      "type": "boolean",
      "description": "Germany Art. 116(2) restoration."
    }
  },
  "required": [
    "ancestryCountry"
  ]
}

Screen whether a startup/SMB likely qualifies for the federal R&D tax credit (26 U.S.C. 41 4-part test), the payroll-tax offset (qualified small business), and SBIR/STTR + state grants, from its activities. VIABILITY DETECTION ONLY — not a filing service, never takes a percentage; hands off to a CPA / the program office.

{
  "type": "object",
  "properties": {
    "activityDescription": {
      "type": "string"
    },
    "activityTechnical": {
      "type": "boolean"
    },
    "facedTechnicalUncertainty": {
      "type": "boolean"
    },
    "didExperimentationOrIteration": {
      "type": "boolean"
    },
    "developingNewOrImprovedProduct": {
      "type": "boolean"
    },
    "grossReceiptsThisYear": {
      "type": "number"
    },
    "yearsWithGrossReceipts": {
      "type": "number"
    },
    "preRevenue": {
      "type": "boolean"
    },
    "hasW2Payroll": {
      "type": "boolean"
    },
    "employeeCount": {
      "type": "number"
    },
    "majorityUsOwned": {
      "type": "boolean"
    },
    "isForProfit": {
      "type": "boolean"
    },
    "state": {
      "type": "string"
    }
  }
}

Detect likely eligibility for a nonprofit hospital's charity-care / financial-assistance (501(r)) + state charity-care law + No Surprises Act, from income vs the Federal Poverty Level. FREE PATIENT INFORMATION — this care is free if you qualify; we never charge a patient to access it. Hands off to the hospital's financial-assistance office.

{
  "type": "object",
  "properties": {
    "householdIncome": {
      "type": "number"
    },
    "householdSize": {
      "type": "number"
    },
    "hospitalIsNonprofit": {
      "type": "boolean"
    },
    "state": {
      "type": "string"
    },
    "wasEmergency": {
      "type": "boolean"
    },
    "gotSurpriseBill": {
      "type": "boolean"
    },
    "billExceedsEstimate": {
      "type": "boolean"
    }
  },
  "required": [
    "householdIncome",
    "householdSize"
  ]
}

Detect under-used EMPLOYER benefits an employee qualifies for (dependent-care FSA, student-loan repayment, fertility/IVF, HSA match), from the plan + the employee's situation. EMPLOYER-PAYS B2B2C, ERISA-aware, non-medical — information + enrollment-nudge only; the plan administrator decides. Hands off to HR / the SPD.

{
  "type": "object",
  "properties": {
    "planOffersDcFsa": {
      "type": "boolean"
    },
    "dependentsUnder13": {
      "type": "number"
    },
    "paysForDependentCare": {
      "type": "boolean"
    },
    "planOffersLoanRepayment": {
      "type": "boolean"
    },
    "hasStudentLoans": {
      "type": "boolean"
    },
    "planOffersFertility": {
      "type": "boolean"
    },
    "interestedInFertility": {
      "type": "boolean"
    },
    "planOffersHsa": {
      "type": "boolean"
    },
    "employerOffersHsaMatch": {
      "type": "boolean"
    },
    "hasHdhp": {
      "type": "boolean"
    }
  }
}

Given a household situation, return the application / recertification / reporting deadlines for the benefits the person likely qualifies for — each with its CFR/statute cite and administering body. The reminder annuity's data spine.

{
  "type": "object",
  "properties": {
    "householdIncome": {
      "type": "number"
    },
    "householdSize": {
      "type": "number"
    }
  },
  "required": [
    "householdIncome",
    "householdSize"
  ]
}