# logsift

Query, filter, and trace logs from GCP, AWS, Azure, Loki, and Elasticsearch — directly from your AI assistant. Ask debugging questions in plain language and get the exact logs back.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add oluwatunmiseolatunbosun2001/logsift

# Browse available tools
npx -y @smithery/cli@latest tool list oluwatunmiseolatunbosun2001/logsift

# Get full schema for a tool
npx -y @smithery/cli@latest tool get oluwatunmiseolatunbosun2001/logsift query_logs

# Call a tool
npx -y @smithery/cli@latest tool call oluwatunmiseolatunbosun2001/logsift query_logs '{}'
```

## Direct MCP Connection

Endpoint: `https://cloud-logsift.run.tools`

**Optional config:**
- `provider` (query) — Cloud provider to use. Supported: gcp, aws, azure, loki, elasticsearch
- `googleApplicationCredentials` (header) — GCP service account JSON
- `awsAccessKeyId` (header) — AWS Access Key ID
- `awsSecretAccessKey` (header) — AWS Secret Access Key
- `azureClientId` (header) — Azure Client ID
- `azureClientSecret` (header) — Azure Client Secret
- `azureTenantId` (header) — Azure Tenant ID
- `lokiBearerToken` (header) — Loki Bearer Token
- `elasticsearchApiKey` (header) — Elasticsearch API Key

## Tools (4)

- `query_logs` — Search and filter log entries by severity, time range, text patterns, and resource type
- `summarize_logs` — Summarize and aggregate log entries - severity counts, top error patterns, time range
- `list_log_sources` — List available log names and resource/source types for the selected scope
- `trace_request` — Trace a request flow across services. Pass a trace_id directly, or use filters to find matching logs and automatically …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get oluwatunmiseolatunbosun2001/logsift <tool-name>
```

## Prompts (3)

- `debug_errors` (scope, window) — Show recent errors from a log scope
- `summarize_recent` (scope, window) — Summarize logs for a scope over a time window
- `trace_request` (scope, trace_id, filter) — Trace a request's journey across services