@olei.io/mcp-server

MCP server for accessing OLEI event data from Claude Desktop, Claude Code, or any MCP-compatible client.

Prerequisites

• An OLEI API key with admin scope (request access from an administrator)
• Node.js >= 20

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "olei": {
      "command": "npx",
      "args": ["-y", "@olei.io/mcp-server"],
      "env": {
        "OLEI_API_KEY": "olei_live_your_key_here"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "olei": {
      "command": "npx",
      "args": ["-y", "@olei.io/mcp-server"],
      "env": {
        "OLEI_API_KEY": "olei_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop / Claude Code after adding the config.

Available Tools

list_localities

List all OLEI localities with their UUIDs. Call this first to find locality UUIDs for searching events.

search_events

Search events by locality and/or geographic area within a date range.

Parameters:

• from_datetime (required) - Start of date range, ISO 8601
• to_datetime (required) - End of date range, ISO 8601
• locality_uuid (optional) - UUID from list_localities
• latitude, longitude, radius_in_meters (optional) - Geographic search
• page, limit (optional) - Pagination

At least locality_uuid or latitude + longitude + radius_in_meters is required.

get_event

Get detailed information about a specific event by UUID.

Parameters:

• event_uuid (required) - UUID of the event

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | OLEI_API_KEY | Yes | - | Your OLEI API key | | OLEI_API_URL | No | Production URL | API base URL override |

Local Development

cd packages/mcp-server
npm install
npx tsc
OLEI_API_KEY=olei_live_xxx node dist/index.js

Publishing

cd packages/mcp-server
npx tsc
npm publish --access public --//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN

Requires a granular access token with read/write permission on @olei.io packages.