# SAMHSA Treatment Locator MCP for AI Agents AI Agent Connect

> SAMHSA Treatment Locator lets your AI agent find official substance use and mental health treatment facilities across the United States. It pulls directly from the Substance Abuse and Mental Health Services Administration database to give you accurate, real-time data on detox centers, inpatient care, and outpatient services. Use it to quickly locate nearby care options, pull contact details for specific facilities, or analyze regional healthcare distribution for research and coordination purposes.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zQEwXMXfw2ctAZXIAC2yufXUCzFlgrT6VTlkQBNA/ai-agent-connect
- **Tags:** mental-health, substance-abuse, facility-locator, public-health, geospatial-search

## Description

The SAMHSA Treatment Locator helps you find the right care for someone struggling with substance abuse or mental health issues. You usually end up with dozens of browser tabs open, trying to figure out which facilities actually offer the specific services a patient needs, like detox or specialized youth programs. It's slow, prone to human error, and frustrating when a facility doesn't actually have the bed you need. This Connector changes that by giving your AI client direct access to the official SAMHSA database. Instead of manual searching, you can ask your agent to find facilities within a specific radius of a zip code or city, filtered by exact service codes. It handles the heavy lifting of navigating complex government data so you can focus on the actual care coordination. It's one of the many high-quality connectors available in the Vinkius catalog, designed to bridge the gap between massive public health datasets and your daily workflow. You get immediate, actionable results whether you're looking for a specific facility's contact info or trying to map out the distribution of mental health resources in a specific county. It makes the process of locating life-saving care much faster and more reliable for everyone involved, from social workers to public health researchers.

## Tools

### get_facility
Get the full contact details and service list for a specific treatment center using its unique ID. This helps you quickly share relevant information with patients or families.

### list_services
See every available service code so you can filter your searches for things like detox or inpatient care. This ensures your search results only include the types of care you actually need.

### search_facilities
Find treatment centers based on geographic coordinates and specific service requirements. Use this to find nearby care options that match your specific clinical criteria.

## Prompt Examples

**Prompt:** 
```
Find any detox centers within 30 miles of Los Angeles.
```

**Response:** 
```
I found 8 detox centers within 30 miles of Los Angeles. Here are the top results:

| Facility Name | Distance | Service Type |
| :--- | :--- | :--- |
| **Hope Recovery** | 4.2 miles | Detox |
| **City Wellness** | 8.7 miles | Detox |
| **Unity Care** | 12.1 miles | Detox |

Would you like the contact details for any of these?
```

**Prompt:** 
```
What services does facility ID FAC123456 offer?
```

**Response:** 
```
I've retrieved the details for facility **FAC123456**:

**Facility Name:** Evergreen Wellness Center
**Services Provided:**
* Outpatient Mental Health
* Specialized Youth Programs
* Group Therapy

They are currently listed as providing these primary services.
```

**Prompt:** 
```
List all the different types of mental health services I can filter for.
```

**Response:** 
```
Here are the available service codes you can use to filter your search:

* **Mental Health:** OP (Outpatient), IP (Inpatient)
* **Substance Use:** DETOX, RES (Residential)
* **Special Programs:** VET (Veterans), LGBTQ

Which category would you like to filter by?
```

## Capabilities

### Find facilities by location
Search for treatment centers within a specific distance of any latitude or longitude.

### Filter by specific care types
Narrow down results to only show detox, inpatient, or outpatient services.

### Pull detailed facility profiles
Get contact information and specific service lists for a single location.

### Browse all available service codes
See the full list of categories to ensure your search filters are accurate.

### Map regional health resources
Identify the density of mental health services across different geographic areas.

## Use Cases

### Emergency Placement
A social worker needs to find an inpatient bed within 50 miles of a patient's current location using search_facilities.

### Regional Analysis
A researcher wants to see how many LGBTQ+ specific mental health programs exist in a specific state to map coverage.

### Patient Outreach
A coordinator needs a list of all outpatient detox centers in a city to provide to a family using search_facilities.

### Data Validation
A clinic wants to verify if a specific facility ID still offers youth mental health services using get_facility.

## Benefits

- Stop manual searching by using search_facilities to find nearby care options instantly.
- Get precise care types by using list_services to identify exact codes for detox or inpatient stay.
- Access direct contact info for patients using get_facility to save time on phone calls.
- Map out regional healthcare gaps for research by pulling large datasets of available centers.
- Reduce errors in patient placement by ensuring every facility matches the required clinical service codes.

## How It Works

The bottom line is you get direct, filtered access to federal healthcare data without manual searching.

1. Subscribe to the Connector and grab your SAMHSA API Key.
2. Input your credentials into your AI client's configuration.
3. Ask your agent to find specific treatment centers or facility details.

## Frequently Asked Questions

**What kind of treatment centers can the SAMHSA Treatment Locator find?**
It finds a wide range of facilities including substance use treatment, mental health centers, detox facilities, and inpatient or outpatient care centers across the US.

**Can I search for facilities based on my current location?**
Yes, you can ask your agent to search for facilities within a specific radius of any latitude and longitude coordinate.

**Does this tool give me phone numbers for the clinics?**
Yes, it retrieves detailed profiles for specific facilities, which include contact information and available services.

**Is this for private clinics too?**
It pulls from the official federal SAMHSA database, which includes many providers but may not include every single private facility.

**How do I filter for specific needs like youth programs?**
You can filter by specific service codes. The tool allows you to identify categories like youth programs, veteran services, and more.

**Can I use this for research projects?**
Absolutely. It's a great way to pull accurate, standardized data for mapping regional healthcare distributions or analyzing service gaps.

**How can I search for treatment facilities near a specific set of coordinates?**
Use the `search_facilities` tool by providing the `lat` (latitude) and `lon` (longitude) parameters. You can also specify a `radius` in miles to define the search area.

**Where can I find the list of service codes to filter my search?**
You can run the `list_services` tool. It will return all available service categories and their corresponding codes which you can then use in the `service_code` parameter of `search_facilities`.

**Can I get the full contact information for a specific facility if I have its ID?**
Yes! Use the `get_facility` tool with the `facility_id`. This will retrieve detailed information including the address, phone number, and the full list of services provided by that location.