{
  "markdown": "# Parseable MCP Server\n\nModel Context Protocol server for [Parseable](https://www.parseable.com). Lets any MCP-capable client (Claude Desktop, Claude Code, Cursor, VS Code Copilot, Windsurf, Continue, Cline, Zed, Codex) discover, query, and manage Parseable datasets and alerts using natural language.\n\n**Two transports:**\n\n| Mode | Transport | Auth | Use when |\n|------|-----------|------|----------|\n| `stdio` | Stdin/stdout | API key via env vars | Claude Desktop, Cursor, VS Code, local clients |\n| `http` | Streamable HTTP | Cloud API key, or self-hosted URL + API key | Hosted deployments and remote clients |\n\n---\n\n## Quickstart — stdio (local)\n\nOne command — interactive setup, detects Claude Desktop / Cursor, writes config files:\n\n```bash\nnpx -y @parseable/parseable-mcp-server init\n```\n\nRestart your MCP client. Tools appear. Done.\n\nScripted:\n\n```bash\nnpx -y @parseable/parseable-mcp-server init \\\n  --client claude-desktop \\\n  --url https://your-parseable.example.com \\\n  --api-key \"$PARSEABLE_API_KEY\"\n```\n\nSupported `--client` values: `claude-desktop`, `cursor`.\n\n### Cursor Marketplace plugin\n\nThe repository also contains a native Cursor plugin manifest. Marketplace installs connect to `https://mcp.parseable.com/mcp` and read credentials from the environment.\n\nSet these variables before starting Cursor:\n\n```bash\nexport PARSEABLE_URL=\"https://your-parseable.example.com\"\nexport PARSEABLE_API_KEY=\"your-api-key\"\nexport PARSEABLE_MODE=\"self-hosted\"\n```\n\n`PARSEABLE_API_KEY` and `PARSEABLE_MODE` are required by the Cursor plugin. Use `PARSEABLE_MODE=cloud` and omit `PARSEABLE_URL` for Parseable Cloud. Use `PARSEABLE_MODE=self-hosted` with `PARSEABLE_URL` for self-hosted Parseable.\n\n```bash\n# Parseable Cloud\nexport PARSEABLE_MODE=\"cloud\"\nexport PARSEABLE_API_KEY=\"your-cloud-api-key\"\nunset PARSEABLE_URL\n```\n\nThen install the Parseable plugin from the Cursor Marketplace. If Cursor was opened from the macOS dock or another GUI launcher that does not inherit shell variables, use the interactive setup instead:\n\n```bash\nnpx -y @parseable/parseable-mcp-server init --client cursor\n```\n\nPlugin metadata lives in `.cursor-plugin/plugin.json`; its MCP connection configuration lives in `mcp.json`. Keep the plugin version aligned with the npm package version when releasing.\n\n---\n\n## Quickstart — HTTP (hosted)\n\nHTTP mode serves a setup page and MCP endpoint from one process. Cloud clients supply an API key. Self-hosted clients supply their Parseable URL and API key.\n\n### 1. Set env vars\n\n```bash\n# .env\nPORT=8787\n```\n\n### 2. Run\n\n```bash\n# From source\nnpm run build:all\nnode dist/server.js http\n\n# Docker\ndocker build -t parseable-mcp-server .\ndocker run -p 8787:8787 --env-file .env parseable-mcp-server\n```\n\n### 3. Connect from Claude\n\n- Claude Desktop → Settings → Connectors → Add custom connector\n- Name: `Parseable`\n- URL: `https://mcp.your-domain.com/mcp`\n- Header `X-Parseable-URL`: `https://your-parseable.example.com`\n- Header `X-API-Key`: your Parseable API key\n- Click Add → Connect\n\n### 4. Connect from Claude Code\n\n```bash\nclaude mcp add --transport http parseable https://mcp.your-domain.com/mcp --scope user \\\n  --header \"X-Parseable-URL: https://your-parseable.example.com\" \\\n  --header \"X-API-Key: $PARSEABLE_API_KEY\"\n```\n\n### 5. Connect from Cursor / VS Code\n\n```json\n{\n  \"mcpServers\": {\n    \"parseable\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.your-domain.com/mcp\",\n      \"headers\": {\n        \"X-Parseable-URL\": \"https://your-parseable.example.com\",\n        \"X-API-Key\": \"your-parseable-api-key\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## HTTP authentication\n\nEach `POST /mcp` request requires `X-API-Key` and supports two modes:\n\n| Mode | Headers |\n|------|---------|\n| Cloud | `X-Parseable-Mode: cloud`, `X-API-Key` |\n| Self-hosted (default) | `X-Parseable-URL`, `X-API-Key` |\n\n`X-Parseable-Mode` is checked first when present. Omitting it selects self-hosted mode; clients do not need to send `X-Parseable-Mode: self-hosted`. In cloud mode, server validates API key with Parseable Cloud, caches returned URL and tenant routing in a bounded in-memory LRU for 24 hours, and sends `x-p-tenant` on Parseable requests. Cache is disposable; misses and process restarts resolve through Cloud again.\n\nFor self-hosted mode, HTTP server validates supplied URL and forwards API key to that Parseable instance. By default, private and loopback Parseable URLs are rejected to limit SSRF. Set `PARSEABLE_MCP_ALLOW_PRIVATE=true` only for trusted deployments that need private network targets.\n\n---\n\n## Environment variables\n\n### stdio mode\n\n| Var | Required | Default | Purpose |\n|-----|----------|---------|---------|\n| `PARSEABLE_URL` | ✅ | — | Parseable base URL |\n| `PARSEABLE_API_KEY` | ✅ | — | API key for self-hosted Parseable |\n| `PARSEABLE_DEFAULT_DATASET` | | — | Advisory default dataset |\n| `PARSEABLE_MAX_ROWS` | | 1000 | Hard cap on query rows |\n| `PARSEABLE_QUERY_TIMEOUT_MS` | | 30000 | HTTP timeout (ms) |\n\n### HTTP mode\n\n| Var | Required | Default | Purpose |\n|-----|----------|---------|---------|\n| `PORT` | | 8787 | HTTP listen port |\n| `PARSEABLE_MCP_ALLOW_PRIVATE` | | false | Permit private/loopback Parseable URLs supplied in request headers |\n| `PARSEABLE_ORCHESTRATOR_URL` | Cloud only | - | Parseable Cloud orchestrator base URL |\n| `PARSEABLE_CLOUD_AUTH_TOKEN` | Cloud only | - | Service bearer token for API-key validation |\n| `PARSEABLE_CLOUD_CACHE_TTL_SECONDS` | | 86400 | Cloud routing LRU TTL |\n| `PARSEABLE_CLOUD_CACHE_MAX_ENTRIES` | | 10000 | Maximum cached cloud API-key routes |\n| `PARSEABLE_CLOUD_VALIDATE_TIMEOUT_MS` | | 10000 | Cloud validation timeout |\n\n### OpenTelemetry (optional)\n\n| Var | Default | Purpose |\n|-----|---------|---------|\n| `PARSEABLE_OTEL_ENABLED` | false | Enable trace export to Parseable |\n| `PARSEABLE_OTEL_ENDPOINT` | — | Parseable OTLP endpoint |\n| `PARSEABLE_OTEL_USERNAME` | — | Basic auth for OTLP |\n| `PARSEABLE_OTEL_PASSWORD` | — | Basic auth for OTLP |\n| `PARSEABLE_OTEL_TRACES_STREAM` | mcp-traces | Stream name for traces |\n| `PARSEABLE_OTEL_DEBUG` | false | Log OTLP export errors |\n\nCopy `.env.example` → `.env` for a full template.\n\n---\n\n## Tools\n\n### Discovery\n\n| Tool | Purpose |\n|------|---------|\n| `list_datasets` | List all log datasets |\n| `get_dataset_schema` | Column names + types |\n| `get_dataset_info` | Metadata (created_at, retention, time window) |\n| `get_dataset_stats` | Event count and storage bytes |\n| `sample_events` | Most recent N events (time-bounded, row-capped) |\n\n### Query\n\n| Tool | Purpose |\n|------|---------|\n| `query_sql` | SQL `SELECT` over a time window. DDL/DML blocked. Auto-injects `LIMIT`. |\n| `query_promql` | PromQL instant or range query against a metrics dataset |\n\n### Alerts\n\n| Tool | Purpose |\n|------|---------|\n| `list_alerts` | List all alerts with state, severity, tags |\n| `get_alert` | Full config for one alert |\n| `list_alert_tags` | All alert tags in use |\n| `enable_alert` | Enable an alert |\n| `disable_alert` | Disable an alert |\n| `evaluate_alert` | Force-evaluate now. **May fire real notifications.** |\n| `create_alert` | Create alert via guided Q&A (8 questions, confirms before submit) |\n\n### Alert targets\n\n| Tool | Purpose |\n|------|---------|\n| `list_alert_targets` | List targets (Slack, webhook, Alertmanager) |\n| `get_alert_target` | Full config for one target |\n| `create_alert_target` | Create a new Slack / webhook / Alertmanager target |\n\n### Diagnostics\n\n| Tool | Purpose |\n|------|---------|\n| `ping` | Check connectivity, return version + health |\n| `explain_query` | `EXPLAIN` a SQL query without executing it |\n\n### RBAC (read-only)\n\n| Tool | Purpose |\n|------|---------|\n| `list_users` | List all users |\n| `get_user_roles` | Roles for a specific user |\n| `list_roles` | All role names |\n| `get_role` | Privilege definition for a role |\n| `get_default_role` | Default role for new users |\n\n### Admin (read-only)\n\n| Tool | Purpose |\n|------|---------|\n| `get_cluster_status` | All nodes with status (distributed mode) |\n| `get_cluster_metrics` | Aggregated ingest/query/storage metrics |\n| `get_retention` | Retention policy for a dataset |\n\n---\n\n## Client setup — stdio\n\n### Claude Desktop\n\n`~/Library/Application Support/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"Parseable\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parseable/parseable-mcp-server\"],\n      \"env\": {\n        \"PARSEABLE_URL\": \"https://your-parseable.example.com\",\n        \"PARSEABLE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add Parseable \\\n  --env PARSEABLE_URL=https://your-parseable.example.com \\\n  --env PARSEABLE_API_KEY=your-api-key \\\n  -- npx -y @parseable/parseable-mcp-server\n```\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"Parseable\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parseable/parseable-mcp-server\"],\n      \"env\": {\n        \"PARSEABLE_URL\": \"https://your-parseable.example.com\",\n        \"PARSEABLE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"Parseable\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parseable/parseable-mcp-server\"],\n      \"env\": {\n        \"PARSEABLE_URL\": \"https://your-parseable.example.com\",\n        \"PARSEABLE_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/parseablehq/parseable-mcp-server.git\ncd parseable-mcp-server\nnpm install\ncp .env.example .env    # fill in your values\n\n# Build\nnpm run build           # server only (tsc)\nnpm run build:ui        # React UI only (vite)\nnpm run build:all       # both\n\n# Run\nnode dist/server.js         # stdio mode\nnode dist/server.js http    # HTTP mode (port 8787)\n\n# Dev\nnpm run dev             # tsc --watch\nnpm run dev:ui          # vite dev server (proxies API to :8787)\nnpm test\nnpm run lint\nnpm run fix             # biome auto-fix\n```\n\nCI (GitHub Actions) runs lint + `build:all` + test on every push/PR to `main` on Node 22. On merge to `main`, Docker image is published to `ghcr.io/parseablehq/parseable-mcp-server`.\n\n---\n\n## Security\n\n- Parseable API keys live in MCP client configuration. Use keys scoped to minimum required permissions.\n- HTTP clients send credentials in `X-Parseable-URL` and `X-API-Key`; always use HTTPS for remote deployments.\n- `query_sql` blocks DDL/DML and enforces a row `LIMIT`. Time window is mandatory.\n- `evaluate_alert` can fire real notifications — review the call before approving.\n- No telemetry. Outbound calls go only to the Parseable instance configured by the user.\n\n---\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE).\n",
  "bytes": 10670,
  "sha": "3b577be635e1899cca51e5ba8c27adca50b40d7ed313d4da2733d3430671401e",
  "repo_slug": "parseablehq/parseable-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_parseablehq_parseable_mcp_serv_bd782dc5/readme"
}