Using GTH with AI Assistants — MCP & API Guide

MCP & API Guide

Use GTH with Claude, ChatGPT & AI Agents

GTH’s MCP server gives AI assistants direct access to 12,000+ licensed substance abuse treatment facilities. Ask natural language questions. Get structured facility data instantly.

12,000+ Licensed Facilities
50 States + DC
Monthly Data Refresh
SAMHSA Verified Source

What You Can Ask

Connect your AI assistant to the GTH MCP server and query the full national treatment database using plain English — no SQL, no API wrangling.

For Operators

  • Find the 5 nearest IOP programs to zip 60601 that accept Medicaid
  • Which detox centers in Nashville accept Blue Cross Blue Shield?
  • Compare treatment facilities near 75201 by insurance acceptance
  • Show me all MAT programs in Chicago with their insurance mix

For Admissions Teams

  • List all residential rehab facilities in Texas that accept Aetna
  • What facilities near Denver offer both IOP and MAT?
  • Find sober living programs within 20 miles of Los Angeles
  • Which facilities in Atlanta accept Medicare for detox?

For Researchers & Consultants

  • How many IOP programs operate in Baltimore, MD?
  • List all SAMHSA-certified MAT providers in Phoenix
  • Compare insurance acceptance rates across Chicago detox centers
  • What levels of care are available in rural Montana?

Connect in 60 Seconds

Three ways to plug GTH into your workflow — choose whichever fits your stack.

1

Claude Desktop

Add the GTH server to your Claude Desktop config file, then restart Claude Desktop. That’s it — GTH tools will appear automatically in your conversations.

{ “mcpServers”: { “gettreatmenthelp”: { “url”: “https://gth-mcp-server.pages.dev/mcp”, “type”: “http” } } }

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on Mac). Restart Claude Desktop. Done.

2

Direct API

Call the MCP endpoint directly from any HTTP client, script, or backend. No authentication required on the free tier.

POST https://gth-mcp-server.pages.dev/mcp Content-Type: application/json { “tool”: “search_facilities”, “arguments”: { “state”: “IL”, “city”: “Chicago”, “treatment_type”: “IOP”, “insurance”: “Medicaid” } }
3

With API Key (Paid Tiers)

Paid plans include a dedicated API key for higher rate limits and usage tracking. Pass your key in the request header.

POST https://gth-mcp-server.pages.dev/mcp X-GTH-API-Key: gth_live_your_key_here Content-Type: application/json

Available Tools

These tools are exposed by the GTH MCP server and available to any connected AI assistant or API client.

Tool What It Does Example
search_facilities Filter by state, city, treatment type, insurance, and more to find matching facilities Find all IOP programs in Chicago that accept Medicaid
get_facility_detail Retrieve the full profile for a specific facility — contact info, services, insurance, certifications Get details on Cumberland Heights Treatment Center
list_states Get a coverage summary broken down by state, including facility counts How many facilities does GTH cover in Texas?
get_treatment_types Return definitions and descriptions for each level of care in the database What’s the difference between IOP and PHP?

The Data Behind GTH

Built on the SAMHSA National Treatment Locator (N-SSATS) — the most comprehensive federal database of substance use disorder treatment facilities in the US.

Total Facilities
12,000+
Licensed substance abuse treatment facilities across the United States
Geographic Coverage
All 50 States + DC
Comprehensive national coverage including Puerto Rico and US territories
Data Source
SAMHSA N-SSATS
National Survey of Substance Abuse Treatment Services — the authoritative federal source
Refresh Cadence
Monthly
Database updated on the 1st of each month with the latest SAMHSA data

What’s Included for Each Facility

  • Insurance acceptance (private, Medicaid, Medicare)
  • Levels of care (Detox, IOP, PHP, Residential, MAT)
  • SAMHSA certifications & accreditations
  • Full contact information & address
  • Geographic coordinates for distance queries
  • Specialty programs & populations served

Simple, Scalable Access

Start free, scale as you grow. No contracts, no setup fees.

Free Tier
$0
No credit card required
  • Public MCP endpoint access
  • Rate limited (standard throttle)
  • No API key required
  • All 4 MCP tools included
  • Ideal for testing & low-volume use
Get Started Free

Ready to connect?

Add GTH to your AI assistant in under a minute. Query 12,000+ treatment facilities with natural language — no code required.