• VALIDATION
  • MAPPING
  • SEARCH
  • HUMAN

How to list healthcare service codes with your AI

Connect the SAMHSA Treatment Locator to your AI client. Your agent then gains access to the full directory of official service categories.

Ask AI about this page

Short answer

How can I get valid healthcare service codes?

Your AI uses the SAMHSA directory to pull the official list of service categories. This ensures your search queries use valid clinical codes instead of guesswork. You'll get a structured set of categories to refine your searches.

The outcomes.

What your AI delivers.

The Connector provides the data your agent needs to stay accurate.

VALIDATION

Verified clinical codes

The AI pulls the exact service categories from SAMHSA. You get a list of codes that are officially recognized.

MAPPING

Correct category matching

Your agent matches user requests to the right clinical categories. This prevents errors from using non-standard terms.

SEARCH

Precise query building

The AI uses these codes to build accurate search parameters. This leads to much better results in the treatment locator.

HUMAN

Manual review required

The AI identifies the codes, but you must confirm they fit the specific patient needs. The agent doesn't make clinical judgments.

The workflow

What your AI does when the request arrives.

The agent handles the heavy lifting of looking up official data.

  1. Fetch directory

    The agent pulls the complete list of service categories from the SAMHSA database.

    list_services

  2. Identify codes

    The AI scans the directory to find the specific clinical codes that match your request.

    list_services

  3. Verify terms

    The agent checks your input against the official categories to ensure the codes are valid.

    list_services

  4. Prepare query

    The AI organizes the valid codes into a format ready for a treatment search.

    list_services

Try it

Copy these to start.

Use these prompts to get the agent working immediately.

Starting points

Swap the text in brackets for the specific service you need to find.

SAMHSA Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_zQEwXMXfw2ctAZXIAC2yufXUCzFlgrT6VTlkQBNA/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — SAMHSA capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "samhsa-treatment-locator-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_zQEwXMXfw2ctAZXIAC2yufXUCzFlgrT6VTlkQBNA/mcp"
    }
  }
}
Copy into chat04

  • List all available service codes from the SAMHSA directory.

  • Find the clinical codes for [substance abuse treatment].

  • Check if [mental health services] is a valid category in the SAMHSA list.

  • Get the service codes for [outpatient care] to use in a search.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect SAMHSA Treatment Locator once, then ask.

Connect your client with one click. Your login stays encrypted on our side, and you can start using the tools right away.

Connect SAMHSA Treatment Locator to your AI

FAQ

How this task behaves

  • 01

    Can the AI create new service codes?

    No. The AI can only retrieve the existing codes from the SAMHSA directory.

  • 02

    Does the AI make clinical decisions?

    No. The AI provides the codes, but you must make all clinical determinations.

  • 03

    How does the AI ensure the codes are current?

    It uses the list_services tool to pull the most recent data from the official directory.

  • 04

    Can I export these codes to a spreadsheet?

    Yes. Once the AI lists the codes, you can copy them into any document or sheet you use.

  • 05

    Will the AI change the SAMHSA data?

    No. The AI only reads the data; it has no permission to modify the official directory.

  • More questions about SAMHSA Treatment Locator? The Connector page answers them. See everything the SAMHSA Treatment Locator Connector can do

Connect SAMHSA to Claude, Cursor, ChatGPT & more