find_eligible_credit_unions

dev.rateapi/mcp · Verify this server

Discovery tool: find candidate credit unions a person may be able to JOIN, from their own facts rather than from a list of institutions. Pass any combination of home, worksite, or payroll geography (these are independent), occupation, employer, school (+school_relationship), associations, military_status, and worship; at least one discriminating fact is required, or pass willing_to_join_association=true as the sole discriminator to search documented joinable-association paths. This evaluates a bounded, prioritized candidate set, not the entire credit-union fleet: read `candidate_limit`, `candidate_set_truncated`, and `candidate_sources`, and never interpret an absent institution as unavailable or ineligible. Returns four buckets within that candidate set — eligible (a verified path already applies), conditionally_eligible (one more step, e.g. joining an association, with the cost and join URL when known), possibly_eligible (a path may apply but a requirement could not be confirmed), and unknown (we could not decide — either we hold no rules for the institution or the supplied facts cannot decide the rules we hold). Every non-positive entry carries a machine-readable `unknown_reason`: `geo_inputs_missing` / `org_inputs_missing` / `inputs_missing` mean ONE MORE FACT FROM THE USER would resolve it, so ask for it and call again; `no_rules` means we hold nothing for that institution and asking will not help; `incomplete_fom`, `fom_completeness_unaffirmed`, `low_confidence_rules` and `unmodeled_condition` mean we hold rules but will not turn a failure against them into a no. Each entry also carries `coverage` — {state, rules_held, last_confirmed_at, fom_affirmed} — describing what we HOLD about the institution as opposed to what we concluded about the person. Each entry carries the credit union id, name, state, confidence, and deterministic reasons. Use this to find supported candidates; use check_membership_eligibility when you already have specific credit_union_ids. Credit unions are never listed as ineligible — absence of evidence is never treated as evidence of absence, and the final membership determination is always the institution's. Every non-positive entry now also carries `missing_facts`: the exact question to ask the person next, the `fact_field` their answer populates, why it matters, and the institution's own words. The response's top-level `next_questions` ranks those questions across all institutions by how many they unlock — ASK THE TOP ONE TO THREE, MERGE THE ANSWERS INTO THE SAME REQUEST BODY, AND CALL AGAIN. Two or three turns is the intended shape of this tool; a single call is a first draft. Stop when `next_questions` is empty, when the top entry's `unlocks_cu_count` is below 2, or after three turns. `unanswerable` lists what no question can fix — institutions we hold no rules for, boundaries we can state but not decide (census tracts, school districts, a radius around an office the page never identifies), and rule sets whose completeness nobody affirmed; do not ask the user about those. Fact fields, in full — supply every one you know: `home_zip`, `home_state`, `home_county`; `work_zip`, `work_state`, `work_county`; `payroll_zip`, `payroll_state`, `payroll_county` (payroll can differ from the worksite and is a separate door); `property_zip`, `property_state`, `property_county` (where they OWN property — never inferred from where they live, and an absentee owner qualifies); `facility_zip`, `facility_state`, `facility_county` (where their business maintains a location); `occupation`; `employer`; `school` plus `school_relationship` (student/alumni/employee — a school name without a relationship affirms nothing); `associations`; `military_status` plus `military_service_state` (state National Guard doors need the state); `worship`; `family_relation` plus `relative_employers`, `relative_schools`, `relative_associations` (a great many people qualify only through a relative — ask); `willing_to_join_association`; `applicant_kind` (person/trust/organization/partnership/corporation — some charters admit entities, and a person is never rejected by an entity-only door, only left unknown); and `asserted_org_qualifiers` (narrowings the person asserts about themselves, e.g. "assigned as a recruiter in Arkansas").