Koskamo

Alcohol.help MCP

A free, read-only MCP server that allows AI assistants to search for US alcohol use disorder treatment programs prescribing medication (naltrexone, acamprosate, disulfiram) by ZIP, state, or city using SAMHSA data.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Alcohol.help MCP logo, by Alcohol.helpVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Alcohol.help
MCP endpoint (Streamable HTTP)
https://alcohol.help/mcp
Vendor documentation

What you can do with it

  • Find treatment programs near a specific ZIP code
  • Search for facilities by state or city
  • Retrieve detailed facility information including medications and payment options

Source and maintenance

Vendor evidenceRegistry 1.2026.1101.0

Protocol and capabilities

Server
alcohol-help 1.0.0
MCP protocol
2025-06-18
Tools
2 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Alcohol.help (alcohol.help) is a free, independent directory of US programs that report to SAMHSA's FindTreatment.gov that they prescribe or give medication for alcohol use disorder, with which of the four FDA-approved medications each reports (naltrexone pill, monthly naltrexone shot, acamprosate, disulfiram), care setting and payment accepted. Use find_treatment to list programs near a ZIP code or in a state or city, and get_facility for one program's full listing. Every result carries the SAMHSA pull date and source link; cite them and the alcohol.help page. The data is SAMHSA's as reported by the programs, not checked by this site and sometimes out of date: tell people to call a program first. A listing is not a recommendation, no program pays for placement, and nothing here is medical advice, a diagnosis or a judgment of whether someone needs or qualifies for treatment. Any licensed prescriber, including a family doctor, can prescribe naltrexone. In an emergency call 911. For crisis support call or text 988. SAMHSA's free, confidential National Helpline is 1-800-662-4357. The site is not affiliated with SAMHSA. How the list is built: https://alcohol.help/about/data/

Tools

2 advertised

find_treatment — Find alcohol treatment programs that prescribe medication
Advertised by the server during the last successful anonymous check.
Advertised read-only

Programs that report to SAMHSA FindTreatment.gov that they prescribe or give medication for alcohol use disorder, near a ZIP code (closest first, straight-line miles) or in a state or city. Each result: name, address or city, phone, which of the four approved medications it reports (naltrexone pill, monthly naltrexone shot, acamprosate, disulfiram), setting, telehealth, payment accepted, an id for get_facility and its alcohol.help page. Filters for medication, setting and payment.

find_treatment input schema
{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "Five-digit US ZIP code, e.g. 85004. Give this, or state."
    },
    "city": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "City within state, e.g. \"Columbus\". Needs state."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 10,
      "minimum": 1,
      "description": "Results per page (1 to 10); page further with offset."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter state code, e.g. OH, when searching a state or city instead of a ZIP."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 2000,
      "minimum": 0,
      "description": "Results to skip, for paging."
    },
    "payment": {
      "enum": [
        "any",
        "medicaid",
        "medicare",
        "private_insurance",
        "sliding_scale_or_free"
      ],
      "type": "string",
      "default": "any",
      "description": "Only programs that report accepting this payment. \"medicaid\" means some Medicaid plans; ask about a specific plan by name."
    },
    "setting": {
      "enum": [
        "any",
        "outpatient",
        "residential",
        "telehealth"
      ],
      "type": "string",
      "default": "any",
      "description": "Only programs that report this care setting."
    },
    "medication": {
      "enum": [
        "any",
        "naltrexone_pill",
        "naltrexone_shot",
        "acamprosate",
        "disulfiram"
      ],
      "type": "string",
      "default": "any",
      "description": "Only programs that report using this FDA-approved alcohol use disorder medication. naltrexone_shot = monthly extended-release injection (Vivitrol)."
    }
  },
  "additionalProperties": false
}
find_treatment annotations
{
  "title": "Find alcohol treatment programs that prescribe medication",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_facility — Details for one alcohol treatment program
Advertised by the server during the last successful anonymous check.
Advertised read-only

Everything alcohol.help lists for one program, by the id find_treatment returns: name, street address, phone, website, the alcohol use disorder medications it reports, care settings, payment accepted, sliding fee scale or no charge, and whether it is alcohol-only, does alcohol detox on site, offers telehealth, family counseling or Spanish, with its page and a correction link.

get_facility input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^p[0-9a-z]{1,8}$",
      "description": "Program id from find_treatment, e.g. \"p18qzktn\"."
    }
  },
  "additionalProperties": false
}
get_facility annotations
{
  "title": "Details for one alcohol treatment program",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
491 ms
95th percentile latency
491 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 491 ms · metadata changed · 2 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http alcohol-help-mcp https://alcohol.help/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add alcohol-help-mcp --url https://alcohol.help/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable alcohol-help-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "alcohol-help-mcp": {
      "url": "https://alcohol.help/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "alcohol-help-mcp": {
      "type": "streamableHttp",
      "url": "https://alcohol.help/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start alcohol-help-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "alcohol-help-mcp": {
      "type": "http",
      "url": "https://alcohol.help/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http alcohol-help-mcp https://alcohol.help/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "alcohol-help-mcp": {
      "url": "https://alcohol.help/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "alcohol-help-mcp": {
      "serverUrl": "https://alcohol.help/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Alcohol.help MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Alcohol.help MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing