ChooseHelp.com · Schema
Choosehelp Com Mcp Tools List
CompanyAddiction TreatmentMental HealthHealthcareDirectoryTherapistsMCP
JSON Schema
{
"result": {
"tools": [
{
"name": "search_facilities",
"title": "Search treatment facilities",
"description": "Search ChooseHelp's directory of published addiction-treatment and mental-health facilities \u2014 rehab centers, detox clinics, outpatient programs, sober living homes \u2014 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 \u2014 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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"state": {
"description": "State \u2014 full name (\"New York\") or ChooseHelp state slug (\"newyork\")",
"type": "string"
},
"city": {
"description": "City name, exact match, e.g. \"Los Angeles\"",
"type": "string"
},
"facility_type": {
"description": "Facility-type slug from list_facility_types, e.g. \"treatment-center\"",
"type": "string"
},
"query": {
"description": "Free-text match against facility names",
"type": "string"
},
"insurance": {
"description": "Insurer name or slug, e.g. \"Aetna\" \u2014 see list_insurers",
"type": "string"
},
"population": {
"description": "Population served, e.g. \"veterans\", \"adolescents\" \u2014 see list_browse_categories",
"type": "string"
},
"approach": {
"description": "Treatment approach, e.g. \"12-step\", \"holistic\" \u2014 see list_browse_categories",
"type": "string"
},
"page": {
"description": "Page number, 10 results per page",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"totalPages": {
"type": "number"
},
"facilities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"types": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"licensed": {
"type": "boolean"
},
"url": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"id",
"name",
"city",
"state",
"types",
"phone",
"licensed",
"url",
"summary"
],
"additionalProperties": false
}
}
},
"required": [
"total",
"page",
"totalPages",
"facilities"
],
"additionalProperties": false
}
},
{
"name": "get_facility",
"title": "Get facility details",
"description": "Full published details for one facility \u2014 by numeric id (from search_facilities) or by (partial) facility name.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "Numeric facility id",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"name": {
"description": "Facility name, partial match accepted",
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"types": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"licensed": {
"type": "boolean"
},
"url": {
"type": "string"
},
"summary": {
"type": "string"
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"type": "string"
},
"ambiguous": {
"description": "True when several facilities matched the name \u2014 pick one from candidates",
"type": "boolean"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"types": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"licensed": {
"type": "boolean"
},
"url": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"id",
"name",
"city",
"state",
"types",
"phone",
"licensed",
"url",
"summary"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
{
"name": "list_states",
"title": "List states with facility counts",
"description": "All states with the number of currently published facilities in each, plus the state directory URL. Counts are computed live.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"states": {
"type": "array",
"items": {
"type": "object",
"properties": {
"state": {
"type": "string"
},
"slug": {
"type": "string"
},
"published_facilities": {
"type": "number"
},
"url": {
"type": "string"
}
},
"required": [
"state",
"slug",
"published_facilities",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"states"
],
"additionalProperties": false
}
},
{
"name": "get_levels_of_care",
"title": "Levels of care explained",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"levels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"label": {
"type": "string"
},
"group": {
"type": "string"
},
"description": {
"type": "string"
},
"published_facilities": {
"type": "number"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"label",
"group",
"description",
"published_facilities",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"levels"
],
"additionalProperties": false
}
},
{
"name": "list_insurers",
"title": "List accepted insurers",
"description": "Insurance providers accepted by published facilities, with live facility counts \u2014 valid values for search_facilities' insurance filter.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"insurers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"published_facilities": {
"type": "number"
}
},
"required": [
"name",
"slug",
"published_facilities"
],
"additionalProperties": false
}
}
},
"required": [
"insurers"
],
"additionalProperties": false
}
},
{
"name": "list_browse_categories",
"title": "Browse categories",
"description": "The directory's browse taxonomy with live facility counts and URLs: populations served (veterans, adolescents, women, LGBTQ+, dual-diagnosis, \u2026) and treatment approaches (12-step, holistic, faith-based, evidence-based modalities, \u2026). Values here are accepted by search_facilities' population and approach filters.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"populations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"published_facilities": {
"type": "number"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"published_facilities",
"url"
],
"additionalProperties": false
}
},
"approaches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"published_facilities": {
"type": "number"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"slug",
"published_facilities",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"populations",
"approaches"
],
"additionalProperties": false
}
},
{
"name": "search_experts",
"title": "Search therapists & experts",
"description": "Search ChooseHelp's licensed therapists, counselors, and addiction specialists \u2014 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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"description": "Free-text match against expert names",
"type": "string"
},
"specialty": {
"description": "Specialty or topic, substring match, e.g. \"anxiety\", \"addiction\"",
"type": "string"
},
"location": {
"description": "City, state, or country substring, e.g. \"California\"",
"type": "string"
},
"online_only": {
"description": "Only experts offering online counseling",
"type": "boolean"
},
"page": {
"description": "Page number, 10 results per page",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"totalPages": {
"type": "number"
},
"experts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"username": {
"type": "string"
},
"name": {
"type": "string"
},
"credentials": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"specialties": {
"type": "array",
"items": {
"type": "string"
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"online_counseling": {
"type": "boolean"
},
"topics_covered": {
"type": "array",
"items": {
"type": "string"
}
},
"url": {
"type": "string"
}
},
"required": [
"username",
"name",
"credentials",
"role",
"location",
"specialties",
"languages",
"online_counseling",
"topics_covered",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"total",
"page",
"totalPages",
"experts"
],
"additionalProperties": false
}
},
{
"name": "get_expert",
"title": "Get expert profile",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"username": {
"type": "string",
"description": "Expert username from search_experts"
}
},
"required": [
"username"
]
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"username": {
"type": "string"
},
"name": {
"type": "string"
},
"credentials": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"specialties": {
"type": "array",
"items": {
"type": "string"
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"online_counseling": {
"type": "boolean"
},
"topics_covered": {
"type": "array",
"items": {
"type": "string"
}
},
"url": {
"type": "string"
},
"therapy_orientation": {
"type": "array",
"items": {
"type": "string"
}
},
"modalities": {
"type": "array",
"items": {
"type": "string"
}
},
"insurance_accepted": {
"type": "array",
"items": {
"type": "string"
}
},
"years_in_practice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"license_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"license_state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone_counseling": {
"type": "boolean"
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"bio": {
"type": "string"
},
"answered_questions": {
"type": "number"
}
},
"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"
],
"additionalProperties": false
}
},
{
"name": "list_facility_types",
"title": "List facility types",
"description": "Facility-type slugs accepted by search_facilities, with display names and directory URLs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true
},
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"types"
],
"additionalProperties": false
}
}
]
},
"jsonrpc": "2.0",
"id": 2
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/choosehelp-com-mcp-tools-list"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.