# monitoringartist/logicmonitor-mcp-server architecture

> Architecture diagram of the GitHub repository monitoringartist/logicmonitor-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/monitoringartist/logicmonitor-mcp-server
- Repository: https://github.com/monitoringartist/logicmonitor-mcp-server

## Overview

LogicMonitor MCP Server exposes LogicMonitor operations to AI assistants through STDIO, SSE, or HTTP. The main workflow is an assistant request handled by the MCP server, dispatched to a tool handler, translated into LogicMonitor REST calls, and returned as a result. The server also provides prompts and resources, while configuration, authentication, authorization, filtering, batching, and rate limiting support the runtime. Transport modes and product capabilities are documented in the README; links between unsampled modules are included only where the source index or excerpts show them.

Main entry points: [`src/servers/server.ts`](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/server.ts) (MCP server), [`src/api/handlers.ts`](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/handlers.ts) (Tool handlers), [`src/api/client.ts`](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/client.ts) (REST API client), [`src/utils/core/cli-config.ts`](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/cli-config.ts) (CLI configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry points"]
  node_stdio["STDIO transport<br/>[stdio.ts]"]
  node_sse["SSE transport<br/>[sse.ts]"]
  node_http["HTTP transport<br/>[streamable-http.ts]"]
  node_server["MCP server<br/>[server.ts]"]
end

subgraph group_capabilities["MCP capabilities"]
  node_tools["Tool catalog<br/>[tools.ts]"]
  node_prompts["Operation prompts<br/>[prompts.ts]"]
  node_resources["MCP resources<br/>[resources.ts]"]
end

subgraph group_logicmonitor["LogicMonitor operations"]
  node_handlers["Tool handlers<br/>[handlers.ts]"]
  node_client["REST API client<br/>[client.ts]"]
end

subgraph group_security["Configuration and security"]
  node_config["CLI configuration<br/>[cli-config.ts]"]
  node_oauth["OAuth strategies<br/>[oauth-strategy.ts]"]
  node_jwt["JWT validation<br/>[jwt-validator.ts]"]
  node_scopes["Scope authorization<br/>[scope-manager.ts]"]
  node_token["Token refresh<br/>[token-refresh.ts]"]
end

subgraph group_support["Request utilities"]
  node_filters["Filter formatting<br/>[filters.ts]"]
  node_batch["Batch processing<br/>[batch-processor.ts]"]
  node_rate["Rate limiting<br/>[rate-limiter.ts]"]
  node_errors["MCP errors<br/>[error-handler.ts]"]
end

node_assistant(("AI assistant"))
node_lm["LogicMonitor API"]

node_assistant -->|"sends requests"| node_stdio
node_assistant -->|"sends requests"| node_sse
node_assistant -->|"sends requests"| node_http
node_stdio -->|"serves MCP"| node_server
node_sse -->|"serves MCP"| node_server
node_http -->|"serves MCP"| node_server
node_server -->|"registers tools"| node_tools
node_server -->|"dispatches requests"| node_handlers
node_server -->|"serves prompts"| node_prompts
node_server -->|"reads resources"| node_resources
node_handlers -->|"calls operations"| node_client
node_client -->|"sends REST requests"| node_lm
node_handlers -->|"formats filters"| node_filters
node_handlers -->|"uses batching"| node_batch
node_batch -->|"retries requests"| node_rate
node_client -->|"limits requests"| node_rate
node_handlers -->|"raises errors"| node_errors
node_config -->|"configures runtime"| node_server
node_config -->|"configures OAuth"| node_oauth
node_server -->|"validates tokens"| node_jwt
node_server -->|"checks scopes"| node_scopes
node_server -->|"refreshes tokens"| node_token

click node_stdio "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/stdio.ts"
click node_sse "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/sse.ts"
click node_http "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/streamable-http.ts"
click node_server "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/server.ts"
click node_tools "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/tools.ts"
click node_prompts "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/prompts.ts"
click node_resources "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/resources.ts"
click node_handlers "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/handlers.ts"
click node_client "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/client.ts"
click node_config "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/cli-config.ts"
click node_oauth "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/oauth-strategy.ts"
click node_jwt "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/jwt-validator.ts"
click node_scopes "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/scope-manager.ts"
click node_token "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/token-refresh.ts"
click node_filters "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/helpers/filters.ts"
click node_batch "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/helpers/batch-processor.ts"
click node_rate "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/rate-limiter.ts"
click node_errors "https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/error-handler.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stdio,node_sse,node_http,node_server toneBlue
class node_tools,node_prompts,node_resources toneAmber
class node_handlers,node_client,node_lm toneMint
class node_config,node_oauth,node_jwt,node_scopes,node_token toneRose
class node_filters,node_batch,node_rate,node_errors,node_assistant toneIndigo
```

## Components

### MCP entry points

- [STDIO transport](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/stdio.ts): `src/servers/stdio.ts`
- [SSE transport](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/sse.ts): `src/servers/sse.ts`
- [HTTP transport](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/streamable-http.ts): `src/servers/streamable-http.ts`
- [MCP server](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/servers/server.ts): `src/servers/server.ts`

### MCP capabilities

- [Tool catalog](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/tools.ts): `src/api/tools.ts`
- [Operation prompts](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/prompts.ts): `src/api/prompts.ts`
- [MCP resources](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/resources.ts): `src/api/resources.ts`

### LogicMonitor operations

- [Tool handlers](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/handlers.ts): `src/api/handlers.ts`
- [REST API client](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/api/client.ts): `src/api/client.ts`

### Configuration and security

- [CLI configuration](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/cli-config.ts): `src/utils/core/cli-config.ts`
- [OAuth strategies](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/oauth-strategy.ts): `src/utils/core/oauth-strategy.ts`
- [JWT validation](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/jwt-validator.ts): `src/utils/core/jwt-validator.ts`
- [Scope authorization](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/scope-manager.ts): `src/utils/core/scope-manager.ts`
- [Token refresh](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/token-refresh.ts): `src/utils/core/token-refresh.ts`

### Request utilities

- [Filter formatting](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/helpers/filters.ts): `src/utils/helpers/filters.ts`
- [Batch processing](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/helpers/batch-processor.ts): `src/utils/helpers/batch-processor.ts`
- [Rate limiting](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/rate-limiter.ts): `src/utils/core/rate-limiter.ts`
- [MCP errors](https://github.com/monitoringartist/logicmonitor-mcp-server/blob/main/src/utils/core/error-handler.ts): `src/utils/core/error-handler.ts`

### Other components

- **AI assistant**
- **LogicMonitor API**

## Connections

- AI assistant → STDIO transport: sends requests (evidence: `README.md`)
- AI assistant → SSE transport: sends requests (evidence: `README.md`)
- AI assistant → HTTP transport: sends requests (evidence: `README.md`)
- STDIO transport → MCP server: serves MCP (evidence: `src/servers/stdio.ts`)
- SSE transport → MCP server: serves MCP (evidence: `src/servers/index.ts`)
- HTTP transport → MCP server: serves MCP (evidence: `README.md`)
- MCP server → Tool catalog: registers tools (evidence: `src/servers/index.ts`)
- MCP server → Tool handlers: dispatches requests (evidence: `src/servers/server.ts`)
- MCP server → Operation prompts: serves prompts (evidence: `src/servers/server.ts`)
- MCP server → MCP resources: reads resources (evidence: `src/servers/server.ts`)
- Tool handlers → REST API client: calls operations (evidence: `src/api/handlers.ts`)
- REST API client → LogicMonitor API: sends REST requests (evidence: `src/api/client.ts`)
- Tool handlers → Filter formatting: formats filters (evidence: `src/api/handlers.ts`)
- Tool handlers → Batch processing: uses batching (evidence: `src/api/handlers.ts`)
- Batch processing → Rate limiting: retries requests (evidence: `src/utils/helpers/batch-processor.ts`)
- REST API client → Rate limiting: limits requests (evidence: `src/api/client.ts`)
- Tool handlers → MCP errors: raises errors (evidence: `src/api/handlers.ts`)
- CLI configuration → MCP server: configures runtime (evidence: `src/servers/index.ts`)
- CLI configuration → OAuth strategies: configures OAuth (evidence: `src/utils/core/oauth-strategy.ts`)
- MCP server → JWT validation: validates tokens (evidence: `src/servers/index.ts`)
- MCP server → Scope authorization: checks scopes (evidence: `src/servers/index.ts`)
- MCP server → Token refresh: refreshes tokens (evidence: `src/servers/index.ts`)
