MCP Server

Connect GoodLogs to AI-powered IDEs like Cursor, Windsurf, or Claude Desktop using the Model Context Protocol.

Installation

bash

npm install -g @aj-2000-test/goodlogs-mcp

Configuration

Add to your IDE's MCP config:

json

{
  "mcpServers": {
    "goodlogs": {
      "command": "npx",
      "args": ["@aj-2000-test/goodlogs-mcp"],
      "env": {
        "GOODLOGS_API_KEY": "gl_sk_your_secret_key"
      }
    }
  }
}

The API region is auto-detected from the key (e.g. gl_sk_eu_... → EU). To override, set GOODLOGS_API_URL.

Note: search_docs works without an API key. All other tools require GOODLOGS_API_KEY.

Available Tools

gql — run GQL queries against your data (search and aggregate logs/events)
get_schema — discover available fields, types, and sample values
get_project_info — get project details, org info, billing plan, and usage stats
search_docs — search GoodLogs documentation for syntax and feature help (no API key required)

Example Prompts

→ "Query my GoodLogs for recent payment errors"
→ "Show error count by severity for the last 24 hours"
→ "What event names exist in my GoodLogs project?"
→ "How do I use BETWEEN in GQL?"

Finding Your API Key

Create an API key at Dashboard → Settings → API Keys. Keys use the format gl_sk_<region>_<secret>.