Skip to main content

Search events with Claude Code

AI summary
Explains how to query Imply Lumi events using Claude Code and the Model Context Protocol. Covers obtaining authentication details and registering your Lumi MCP server. Shows how to ask natural language questions and view SQL queries with results from Claude CLI.

About AI summaries.

You can use Claude Code to query Imply Lumi events directly from your terminal. The MCP integration connects Lumi to the Claude CLI through the Model Context Protocol (MCP), enabling you to ask natural language questions, view the generated SQL query, and access query results.

Prerequisites​

To query Lumi events with Claude Code, you need the following:

You also need a Claude account with access to the Claude CLI. Before you begin, install the Claude CLI and log in. See Claude Code overview for details.

Obtain Lumi authentication details​

To obtain the details you need from Lumi:

  1. Go to the Model Context Protocol (MCP) integration page in Lumi and select your IAM key.
  2. Select the Claude Code AI agent. Claude Code integration
  3. Copy the details under Authentication and access on the right:
    • Endpoint: URL resembling https://mcp.lumi.imply.io
    • Token: API token resembling 0b8d890e-0bc4-4208-ab68-c195c00d76b0
  4. Copy the code snippet in Configure Claude Code. You'll need it in the next step.

Configure Claude​

To register your Lumi MCP server with Claude, access the Claude CLI and run the snippet you saved in Obtain Lumi authentication details. For example:

claude mcp add imply-lumi \
  --transport http \
  --header "X-Lumi-Auth: 0b8d890e-0bc4-4208-ab68-c195c00d76b0" \
  https://mcp.lumi.imply.io

A successful connection produces a message similar to:

Successfully added the imply-lumi MCP server to your Claude configuration with HTTP transport and the X-Lumi-Auth header.

Query Lumi from Claude CLI​

You can now query Lumi from the Claude CLI using natural language. For example, "@imply-lumi What are the top 10 sources this week?" Claude displays the SQL it uses to run the query and the result.

Example response:

Claude Code example query

Learn more​

See the following topics for more information: