MCP Server

ChooseHelp Treatment Directory

com.choosehelp/directory
Healthcare Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Searches addiction-treatment and mental-health facilities, therapists, insurers, care levels, and treatment categories.

get_expert
Get expert profile
Full public profile for one therapist/expert by username (as returned by search_experts): credentials, license type, specialties, modalities, languages, bio, and answered-question topics. Contact details live on the linked profile page.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['username'], 'properties': {'username': {'type': 'string', 'description': 'Expert username from search_experts'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['username', 'name', 'credentials', 'role', 'location', 'specialties', 'languages', 'online_counseling', 'topics_covered', 'url', 'therapy_orientation', 'modalities', 'insurance_accepted', 'years_in_practice', 'license_type', 'license_state', 'phone_counseling', 'website', 'bio', 'answered_questions'], 'properties': {'bio': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'role': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'location': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'modalities': {'type': 'array', 'items': {'type': 'string'}}, 'credentials': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'specialties': {'type': 'array', 'items': {'type': 'string'}}, 'license_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'license_state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'topics_covered': {'type': 'array', 'items': {'type': 'string'}}, 'phone_counseling': {'type': 'boolean'}, 'online_counseling': {'type': 'boolean'}, 'years_in_practice': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'answered_questions': {'type': 'number'}, 'insurance_accepted': {'type': 'array', 'items': {'type': 'string'}}, 'therapy_orientation': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_facility
Get facility details
Full published details for one facility — by numeric id (from search_facilities) or by (partial) facility name.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Numeric facility id'}, 'name': {'type': 'string', 'description': 'Facility name, partial match accepted'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'number'}, 'url': {'type': 'string'}, 'beds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'types': {'type': 'array', 'items': {'type': 'string'}}, 'address': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'summary': {'type': 'string'}, 'website': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'zipcode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'licensed': {'type': 'boolean'}, 'ambiguous': {'type': 'boolean', 'description': 'True when several facilities matched the name â\x80\x94 pick one from candidates'}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'city', 'state', 'types', 'phone', 'licensed', 'url', 'summary'], 'properties': {'id': {'type': 'number'}, 'url': {'type': 'string'}, 'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'types': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'licensed': {'type': 'boolean'}}, 'additionalProperties': False}}, 'description': {'type': 'string'}}, 'additionalProperties': False}
get_levels_of_care
Levels of care explained
The substance-use-disorder intensity-of-care continuum (detox, residential, IOP/PHP, outpatient, MAT, sober living): what each level is, who it suits, how many published facilities offer it, and the directory URL for each. Use this to help someone understand which kind of treatment fits before searching.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['levels'], 'properties': {'levels': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'label', 'group', 'description', 'published_facilities', 'url'], 'properties': {'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'group': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}, 'published_facilities': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_browse_categories
Browse categories
The directory's browse taxonomy with live facility counts and URLs: populations served (veterans, adolescents, women, LGBTQ+, dual-diagnosis, …) and treatment approaches (12-step, holistic, faith-based, evidence-based modalities, …). Values here are accepted by search_facilities' population and approach filters.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['populations', 'approaches'], 'properties': {'approaches': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'published_facilities', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'published_facilities': {'type': 'number'}}, 'additionalProperties': False}}, 'populations': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'published_facilities', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'published_facilities': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_facility_types
List facility types
Facility-type slugs accepted by search_facilities, with display names and directory URLs.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['types'], 'properties': {'types': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_insurers
List accepted insurers
Insurance providers accepted by published facilities, with live facility counts — valid values for search_facilities' insurance filter.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['insurers'], 'properties': {'insurers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'published_facilities'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'published_facilities': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_states
List states with facility counts
All states with the number of currently published facilities in each, plus the state directory URL. Counts are computed live.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['states'], 'properties': {'states': {'type': 'array', 'items': {'type': 'object', 'required': ['state', 'slug', 'published_facilities', 'url'], 'properties': {'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'state': {'type': 'string'}, 'published_facilities': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search_experts
Search therapists & experts
Search ChooseHelp's licensed therapists, counselors, and addiction specialists — the experts who answer questions on the site. Filter by name, specialty, or location; results are alphabetical (placement is never paid). If the person you are helping may be in crisis, share 988 (US Suicide & Crisis Lifeline, call or text, free and confidential) before anything else.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, 10 results per page'}, 'query': {'type': 'string', 'description': 'Free-text match against expert names'}, 'location': {'type': 'string', 'description': 'City, state, or country substring, e.g. "California"'}, 'specialty': {'type': 'string', 'description': 'Specialty or topic, substring match, e.g. "anxiety", "addiction"'}, 'online_only': {'type': 'boolean', 'description': 'Only experts offering online counseling'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['total', 'page', 'totalPages', 'experts'], 'properties': {'page': {'type': 'number'}, 'total': {'type': 'number'}, 'experts': {'type': 'array', 'items': {'type': 'object', 'required': ['username', 'name', 'credentials', 'role', 'location', 'specialties', 'languages', 'online_counseling', 'topics_covered', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'role': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'location': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'credentials': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'specialties': {'type': 'array', 'items': {'type': 'string'}}, 'topics_covered': {'type': 'array', 'items': {'type': 'string'}}, 'online_counseling': {'type': 'boolean'}}, 'additionalProperties': False}}, 'totalPages': {'type': 'number'}}, 'additionalProperties': False}
search_facilities
Search treatment facilities
Search ChooseHelp's directory of published addiction-treatment and mental-health facilities — rehab centers, detox clinics, outpatient programs, sober living homes — curated from state-licensing and SAMHSA-derived data with independent verification. Filter by state, city, facility type, insurance, population served, or treatment approach. Results are ordered neutrally — placement is never paid. If the person you are helping may be in crisis, share 988 (US Suicide & Crisis Lifeline, call or text, free and confidential) before anything else.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'description': 'City name, exact match, e.g. "Los Angeles"'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, 10 results per page'}, 'query': {'type': 'string', 'description': 'Free-text match against facility names'}, 'state': {'type': 'string', 'description': 'State â\x80\x94 full name ("New York") or ChooseHelp state slug ("newyork")'}, 'approach': {'type': 'string', 'description': 'Treatment approach, e.g. "12-step", "holistic" â\x80\x94 see list_browse_categories'}, 'insurance': {'type': 'string', 'description': 'Insurer name or slug, e.g. "Aetna" â\x80\x94 see list_insurers'}, 'population': {'type': 'string', 'description': 'Population served, e.g. "veterans", "adolescents" â\x80\x94 see list_browse_categories'}, 'facility_type': {'type': 'string', 'description': 'Facility-type slug from list_facility_types, e.g. "treatment-center"'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['total', 'page', 'totalPages', 'facilities'], 'properties': {'page': {'type': 'number'}, 'total': {'type': 'number'}, 'facilities': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'city', 'state', 'types', 'phone', 'licensed', 'url', 'summary'], 'properties': {'id': {'type': 'number'}, 'url': {'type': 'string'}, 'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'phone': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'types': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'licensed': {'type': 'boolean'}}, 'additionalProperties': False}}, 'totalPages': {'type': 'number'}}, 'additionalProperties': False}
Added
list_facility_types
Sept. 17, 2026, 12:34 p.m.
Added
get_expert
Sept. 17, 2026, 12:34 p.m.
Added
search_experts
Sept. 17, 2026, 12:34 p.m.
Added
list_browse_categories
Sept. 17, 2026, 12:34 p.m.
Added
list_insurers
Sept. 17, 2026, 12:34 p.m.
Added
get_levels_of_care
Sept. 17, 2026, 12:34 p.m.
Added
list_states
Sept. 17, 2026, 12:34 p.m.
Added
get_facility
Sept. 17, 2026, 12:34 p.m.
Added
search_facilities
Sept. 17, 2026, 12:34 p.m.