SolarWinds Observability MCP Server

An MCP (Model Context Protocol) server that wraps the SolarWinds Observability API, enabling Claude Code to directly query logs, metrics, entities, and traces.

Setup

1. Install dependencies:

npm install

2. Build:

npm run build

3. Set your API token:

export SWO_API_TOKEN=your-token-here
# or
export PAPERTRAIL_TOKEN=your-token-here

Configure Claude Code

Add the MCP server via the CLI:

claude mcp add solarwinds -e PAPERTRAIL_TOKEN=your-token -- node /path/to/solarwinds-mcp/dist/index.js

Verify it's connected:

claude mcp list

To remove:

claude mcp remove solarwinds

Available Tools

search_logs

Search logs with filtering and pagination.

• query (required): Search filter string
• daysBack: Look back N days (default: 1)
• maxPages: Maximum pages to fetch (default: 10)
• direction: "forward" or "backward" (default: backward)

get_request_logs

Fetch all logs for a specific request ID.

• requestId (required): UUID request ID
• daysBack: Look back N days (default: 7)

analyze_requests

Search logs and group/analyze by request ID (replicates the Ruby script workflow).

• query (required): Search filter
• daysBack: Look back N days (default: 1)
• fetchRelatedLogs: Fetch all logs for discovered request IDs (default: true)
• maxRequestIds: Maximum request IDs to process (default: 50)

get_metrics

Query metrics data.

• metricName: Specific metric name
• entityId: Filter by entity ID
• daysBack: Look back N days (default: 1)

list_entities

List entities (hosts, services, applications).

• type: Entity type filter
• limit: Maximum results (default: 100)

get_spans

Retrieve trace spans.

• traceId: Specific trace ID
• serviceName: Filter by service
• daysBack: Look back N days (default: 1)

Testing

Test with MCP Inspector:

npx @modelcontextprotocol/inspector dist/index.js

Environment Variables

Variable	Required	Default	Description
SWO_API_TOKEN	Yes*	-	SolarWinds API token
PAPERTRAIL_TOKEN	Yes*	-	Alternative token name
SWO_REGION	No	na-01	API region (na-01, na-02, eu-01, ap-01)
SWO_MAX_RETRIES	No	6	Max retry attempts
SWO_TIMEOUT_MS	No	30000	Request timeout in ms

*Either SWO_API_TOKEN or PAPERTRAIL_TOKEN is required.