MCP Server for Logz.io


An unofficial\* Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Logz.io's log management platform. Includes tools for simple log search, Lucene query search, and fetching basic statistics from logz io.

\I'll be a little surprised if logz io makes an official* MCP server. Instead, they seem to be leaning heavily into integrating AI directly into their tooling, which makes sense, but doesn't give the user much flexibility over models or integration with external tools.. which is why this project exists.

🚀 Quick Start

Add this to your Claude/Cursor/etc configuration file:

``python
{
"mcpServers": {

# other servers ...

"logzio": {
"command": "npx",
"args": [
"-y",
"mcp-server-logzio",
"apiKey", "YOUR_LOGZIO_API_KEY"
]
}
}
}
`

US is the default region. For other regions:

`python
{
"mcpServers": {

# other servers ...

"logzio": {
"command": "npx",
"args": [
"-y",
"mcp-server-logzio",
"apiKey", "YOUR_LOGZIO_API_KEY",
"region", "eu" # add this for example
]
}
}
}
`

🛠️ Advanced Configuration

$3

| Argument | Description | Default | Required |
|----------|-------------|---------|----------|
| apiKey | Your Logz.io API key | - | Yes |
| region | Logz.io region (us, us-west, eu, ca, au, uk) | us | No |
| logzioUrl | Custom Logz.io API URL (overrides region) | - | No |
| --timeout | Request timeout | 30000 | No |
| --retry-attempts | Retry attempts | 3 | No |
| --max-results | Max results per query | 1000 | No |

$3

The server automatically maps region codes to the correct Logz.io API endpoints:

| Region Code | Description | API Endpoint |
|-------------|-------------|--------------|
| us | US East (default) | https://api.logz.io |
| us-west | US West | https://api-wa.logz.io |
| eu | Europe | https://api-eu.logz.io |
| ca | Canada | https://api-ca.logz.io |
| au | Australia | https://api-au.logz.io |
| uk | United Kingdom | https://api-uk.logz.io |

Finding Your Region: Log into your Logz.io account and check the URL in your browser:
- https://app.logz.io → use region us
- https://app-eu.logz.io → use region eu
- https://app-ca.logz.io → use region ca
- etc.

🔧 Available Tools

These are the tools your agent will see.

$3

Search through logs with simple queries and filters.

Parameters:
- query (required): Search query string
- timeRange: Time range (1h, 6h, 12h, 24h, 3d, 7d, 30d)
- from/to: Custom time range (ISO 8601)
- logType: Filter by log type
- severity: Filter by severity level
- limit: Maximum results (1-1000)
- sort: Sort order (asc/desc)

$3

For more advanced search using Lucene queries

Parameters:
- luceneQuery (required): Lucene query string
- from/to: Time range (ISO 8601)
- size: Maximum results (1-1000)
- sort: Sort order (asc/desc)

$3

Retrieve aggregated log statistics and metrics.

Parameters:
- timeRange: Time range (1h, 6h, 12h, 24h, 3d, 7d, 30d)
- from/to: Custom time range (ISO 8601)
- groupBy: Fields to group by

🏗️ Development, if you want to mess with the code

$3

- Node.js 18+
- TypeScript 5.8+
- Valid Logz.io account and API key

$3

`bash


Clone the repository

git clone https://github.com/modelcontextprotocol/mcp-server-logzio.git
cd mcp-server-logzio

Install dependencies

npm install

Build the project

npm run build

Run tests

npm test

Run in development mode

npm run dev
`

$3

- npm run build - Compile TypeScript
- npm run dev - Run in development mode
- npm test - Run test suite
- npm run format - Format code with Prettier
- npm run type-check - Type check without emission

📁 Project Structure

`
mcp-server-logzio/
├── src/
│ ├── api/ # Logz.io API client and types
│ ├── tools/ # MCP tool implementations
│ ├── utils/ # Utilities (logging, errors)
│ ├── config.ts # Configuration management
│ ├── server.ts # MCP server implementation
│ └── index.ts # Entry point
├── tests/ # Test suites
├── examples/ # Usage examples
├── docs/ # Documentation
└── dist/ # Compiled output
``