Skip to main content
Glama
bmlt-mcp-server

bmlt-mcp-server

by jbonjour

bmlt-mcp-server

Ein MCP (Model Context Protocol)-Server für die Basic Meeting List Toolbox (BMLT) — die Open-Source-Meeting-Datenbank, die von Narcotics Anonymous Service-Gremien weltweit genutzt wird.

Verbinde Claude (oder einen beliebigen MCP-kompatiblen KI-Client) mit einem BMLT-Root-Server und frage NA-Meeting-Daten in natürlicher Sprache ab.


Was er tut

Stellt vier Tools bereit:

Tool

Beschreibung

bmlt_search_meetings

Suche Meetings nach Tag, Format, Ort, Name oder Geokoordinaten

bmlt_get_meeting_details

Rufe alle Details für ein bestimmtes Meeting per ID ab

bmlt_get_formats

Liste alle Meeting-Format-Codes und Beschreibungen auf (O, C, VM, BT, etc.)

bmlt_get_service_bodies

Liste alle Service-Gremien (Gebiete/Regionen) auf dem Root-Server auf

bmlt_get_server_info

Überprüfe die Root-Server-Version und das geografische Zentrum

Beispiel-Prompts nach der Verbindung

  • "Welche NA-Meetings finden heute Abend in Portland statt?"

  • "Finde offene virtuelle Meetings am Dienstag"

  • "Zeige mir alle Meetings im Umkreis von 5 Meilen um die Innenstadt von Portland"

  • "Was bedeutet der Format-Code 'BT'?"

  • "Liste alle Service-Gremien auf dem WSZF-Server auf"


Related MCP server: GoHighLevel MCP Starter

Standardeinstellungen

Standardmäßig verweist der Server auf:

  • Root-Server: https://bmlt.wszf.org/main_server (WSZF-Netzwerk)

  • Standard-Service-Gremium: 26 (Portland Area NA)

Alle Tools akzeptieren einen root_server_url-Parameter, um auf jeden beliebigen BMLT-Root-Server zu verweisen, sowie service_body_ids, um Suchen auf andere Gebiete einzugrenzen.


Installation

git clone https://github.com/jbonjour/bmlt-mcp-server.git
cd bmlt-mcp-server
npm install
npm run build

Verwendung

Mit Claude Desktop (stdio — empfohlen)

Füge dies zur Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "bmlt": {
      "command": "node",
      "args": ["/absolute/path/to/bmlt-mcp-server/dist/index.js"]
    }
  }
}

Starte Claude Desktop neu. Du wirst die BMLT-Tools in deinem Chat verfügbar sehen.

Mit Claude Code

claude mcp add bmlt node /absolute/path/to/bmlt-mcp-server/dist/index.js

HTTP-Modus (für Remote-/Multi-Client-Nutzung)

TRANSPORT=http PORT=3000 node dist/index.js
# Server listens on http://localhost:3000/mcp

Entwicklung

npm install
npm run build      # compile TypeScript → dist/
npm start          # run compiled server (stdio)

# Or run via HTTP for testing:
TRANSPORT=http PORT=3000 npm start

Zum Testen mit dem MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Umgebungsvariablen

Variable

Standard

Beschreibung

TRANSPORT

stdio

Transportmodus: stdio oder http

PORT

3000

HTTP-Port (wird nur verwendet, wenn TRANSPORT=http)


Ändern des Standard-Root-Servers oder Service-Gremiums

Bearbeite src/constants.ts:

export const DEFAULT_ROOT_SERVER = "https://bmlt.wszf.org/main_server";
export const DEFAULT_SERVICE_BODY_ID = 26; // Portland NA

Dann neu erstellen: npm run build


BMLT-Root-Server

Jedes NA-Service-Gremium, das BMLT betreibt, kann abgefragt werden. Gängige Root-Server:

Netzwerk

URL

WSZF (Pacific Northwest)

https://bmlt.wszf.org/main_server

NA World Services (Aggregator)

https://na.org/main_server

Finde den Root-Server deiner Region unter bmlt.app.


Mitwirken

PRs sind willkommen. Dies wurde entwickelt, um das Website-Modernisierungsprojekt der Portland Area NA zu unterstützen, und wurde für die breitere NA-Tech-Community als Open Source veröffentlicht.


Lizenz

MIT — frei zu verwenden, zu teilen und zu verändern. Alle Arbeiten wurden von und für die NA-Community durchgeführt.

Available Tools

5 tools
bmlt_get_formatsGet Meeting FormatsA
Read-onlyIdempotent

Retrieve all meeting format codes and their descriptions from a BMLT root server.

Formats describe the type of meeting — e.g. "O" = Open, "C" = Closed, "VM" = Virtual Meeting, "BT" = Book Study, "D" = Discussion, "SP" = Speaker, "WC" = Wheelchair Accessible.

Use this to:

  • Discover what format codes are available before filtering a meeting search

  • Explain what a format code means to a user

  • List all available meeting types on the server

Args:

  • root_server_url (string, optional): BMLT root server URL. Defaults to "https://bmlt.wszf.org/main_server"

  • response_format (string, optional): "markdown" (default) or "json"

Returns: List of format codes, names, and descriptions.

Inputs: root_server_url, response_format.

bmlt_get_meeting_detailsGet Meeting DetailsA
Read-onlyIdempotent

Retrieve full details for a specific NA meeting by its BMLT meeting ID.

Use this after bmlt_search_meetings to get the complete record for a specific meeting.

Args:

  • meeting_id (number): The BMLT meeting ID (the "id_bigint" field from search results)

  • root_server_url (string, optional): BMLT root server URL. Defaults to "https://bmlt.wszf.org/main_server"

  • service_body_ids (number[], optional): Service body IDs to scope the search. Defaults to [26]

  • response_format (string, optional): "markdown" (default) or "json"

Returns: Full meeting record including name, day, time, location, formats, virtual links, and all metadata fields.

Inputs: meeting_id (required), root_server_url, service_body_ids, response_format.

bmlt_get_server_infoGet Server InfoA
Read-onlyIdempotent

Retrieve metadata about a BMLT root server, including version and geographic center.

Use this to verify a server is reachable, check its version, or get its default center coordinates.

Args:

Returns: Server version, center lat/lng, default zoom level, and region bias.

Inputs: root_server_url.

bmlt_get_service_bodiesGet Service BodiesA
Read-onlyIdempotent

Retrieve all service bodies (NA regions, areas, districts) from a BMLT root server.

Service bodies are the organizational units that manage meeting data in BMLT. Knowing the ID of a service body lets you filter meeting searches to a specific area.

Use this to:

  • Discover service body IDs for use in bmlt_search_meetings

  • See the hierarchy of areas served by a root server

  • Find a specific area's helpline or website

Args:

  • root_server_url (string, optional): BMLT root server URL. Defaults to "https://bmlt.wszf.org/main_server"

  • response_format (string, optional): "markdown" (default) or "json"

Returns: List of service bodies with IDs, names, types, URLs, and helplines.

Example: Portland NA has service body ID 26 on the WSZF root server.

Inputs: root_server_url, response_format.

bmlt_search_meetingsSearch NA MeetingsA
Read-onlyIdempotent

Search for Narcotics Anonymous meetings in the BMLT database.

Returns a list of meetings matching the given filters. All filters are optional — omitting them returns all meetings for the default service body.

Args:

  • root_server_url (string, optional): BMLT root server URL. Defaults to "https://bmlt.wszf.org/main_server"

  • service_body_ids (number[], optional): Filter by service body IDs. Defaults to [26] (Portland NA)

  • weekdays (string[], optional): Filter by day(s) of week. Accepts day names like "Monday", "tuesday", or numbers 1–7 (1=Sunday)

  • formats (string[], optional): Filter by format codes, e.g. ["O"] for Open, ["VM"] for Virtual, ["C"] for Closed

  • meeting_name (string, optional): Search meetings by name (partial match)

  • lat (number, optional): Latitude for geo search. Requires lng.

  • lng (number, optional): Longitude for geo search. Requires lat.

  • radius_miles (number, optional): Search radius in miles when using lat/lng. Default: 10

  • start_time_min (string, optional): Only meetings starting at or after this time, format "HH:MM" (24h)

  • start_time_max (string, optional): Only meetings starting at or before this time, format "HH:MM" (24h)

  • response_format (string, optional): "markdown" (default) or "json"

Returns: Formatted list of meetings with name, day, time, location, formats, and links.

Examples:

  • "Show all Portland NA meetings on Friday" → weekdays: ["Friday"]

  • "Find open meetings near downtown Portland" → formats: ["O"], lat: 45.5231, lng: -122.6765

  • "Virtual meetings this week" → formats: ["VM"]

  • "Morning meetings" → start_time_max: "12:00"

Inputs: root_server_url, service_body_ids, weekdays, formats, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: formats, meeting details, server info, service bodies, and search. There is no overlap, and an agent can easily select the right tool for a given task.

    Naming Consistency5/5

    All tool names follow the predictable pattern 'bmlt_verb_noun' (e.g., bmlt_get_formats, bmlt_search_meetings). The convention is consistent and readable.

    Tool Count5/5

    Five tools is an appropriate number for a read-only meeting information server. Each tool serves a necessary function without being excessive or insufficient.

    Completeness5/5

    The tool set covers all primary operations for querying BMLT meeting data: retrieving metadata (server info, service bodies, formats), searching meetings, and getting detailed records. No obvious gaps exist for the intended read-only use case.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Mindbody, enabling AI agents to fetch client info, query class schedules, book classes/appointments (env-gated), and process checkout (payment-gated).
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that lets AI assistants query your Halaxy practice-management data—appointments, invoices, referrals, and practitioners—via natural language, exposing read-only tools for daily schedules, billing status, and session limits.
      GPL 3.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that exposes OneMap8 fleet tracking to AI clients, enabling natural-language queries about devices, positions, reports, geofences, drivers, and more. Includes 32 tools, permission scoping, and safety guardrails.
      -