Parseable MCP server
io.github.parseablehq/parseable-mcp-server·v0.2.16·4 starsModel Context Protocol server for Parseable. Lets LLMs discover and query Parseable.
4 stars45 downloads/wk
Reviews
Write oneNobody has reviewed Parseable yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Parseable tools (27, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_alertwrite actionCreate a new Parseable alert. BEFORE calling this tool, gather inputs from the user ONE QUESTION AT A TIME. Do not invent values. Ask in this order: 1. "What should this alert be called?" → title 2. "Which dataset should it watch?" → call list_datasets if user is unsure, then pick 3. "What condition should trigger it?" → translate user's natural-language condition into: - alert SQL against the sel
create_alert_targetwrite actionCreate a new notification target (Slack/webhook/Alertmanager). Ask the user step-by-step: name, type, endpoint URL, then type-specific fields (headers for webhook, basic auth for Alertmanager). Confirm full JSON before submitting.
disable_alertDisable an active alert (stops evaluating + firing).
enable_alertEnable a previously-disabled alert.
evaluate_alertForce-evaluate an alert immediately (out-of-schedule). MAY TRIGGER REAL NOTIFICATIONS if threshold breached - confirm with user before running on production alerts.
explain_querywrite actionRun EXPLAIN on a SQL query to see the DataFusion execution plan without executing it. Useful for debugging slow queries, verifying predicate pushdown, and checking partition pruning. Same SELECT-only restriction as query_sql.
get_alertGet full configuration for one alert: query, threshold, evaluation window, targets, tags, state, last fired timestamp.
get_alert_targetGet full config for one alert target (endpoint URL, auth, headers, notification interval).
get_cluster_metricsGet aggregated metrics across all nodes in this Parseable cluster (ingest rate, query latency, storage utilization, errors). Distributed mode only.
get_cluster_statusList all nodes in this Parseable cluster (Prism, Querier, Ingestor, Indexer) with their domains, status, and metadata. Only works on distributed Parseable deployments - standalone instances will return an error.
get_dataset_infoGet metadata for a dataset: created_at, first/last event time, owner, retention, hot-tier config, time partition.
get_dataset_schemaGet the Arrow schema (columns + types) for a dataset. Run this before writing SQL so you know available columns.
get_dataset_statsGet event count, ingested bytes, and storage (compressed) bytes for a dataset. Useful for cost and volume audits.
get_default_roleGet the default role assigned to new users on this Parseable server. Returns the role name, or null if no default is set.
get_retentionGet the retention policy for a dataset - how long data is kept before being deleted, and any tiering rules. Read-only; modification stays in the Parseable UI.
get_roleGet the full privilege definition for a role: which actions (Ingest, Query, GetStream, PutAlert, etc.) the role grants, and which datasets each privilege applies to. Use to answer 'does role X let me write to dataset Y?' style questions.
get_user_rolesGet the roles assigned to a specific user. Returns a map of role name → role definition. Combine with list_roles + get_role to determine effective permissions for a user (which datasets they can read, write, manage alerts on, etc.).
list_alert_tagsList all tags currently in use across alerts. Useful for filtering and grouping alerts by service/team/severity.
list_alert_targetsList all alert notification targets (Slack webhooks, generic webhooks, Alertmanager endpoints) configured on this Parseable server. Returns array of `{id, name, type, ...}`. Use BEFORE create_alert so the user can pick valid target IDs for the alert's `targets` array.
list_alertsList all alerts on this Parseable server with their IDs, names, state (enabled/disabled), severity, and last evaluation. Use first to discover what alerts exist before drilling in with get_alert.
list_datasetsList all log datasets (streams) on this Parseable server. Returns an array of dataset metadata. Use this first to discover what data is available.
list_rolesList all roles defined on this Parseable server. Returns role names. Use get_role on each to inspect privileges. Read-only - this server does not provide role creation/modification.
list_usersList all registered users on this Parseable server. Returns user IDs and basic metadata. Caller must have ListUser permission. Read-only - this server does not provide user creation/deletion.
pingCheck connectivity and report server version/build info. Returns about (version, mode, license, deployment id), liveness, and readiness. Use for diagnosing MCP-server-to-Parseable connection issues.
query_promqlwrite actionExecute a PromQL query against a Parseable metrics dataset. Pass start+end+step for a range query (time series), or omit them for an instant query (single point). Requires a metrics dataset name in `stream`.
query_sqlwrite actionExecute a SQL SELECT against a Parseable dataset over a time window. Use this for any analytical question on logs/events. Run get_dataset_schema first to know columns. Time window is mandatory.
sample_eventsReturn the most recent N events from a dataset. Useful for understanding the shape of data before writing SQL.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan79 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 33 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How Parseable compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 89/100
- higher than 83% of 4,460 AI and agents servers
- Tools
- 27
- the typical AI and agents server has 6
- Tools that change things
- 19%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 77% of 2,711 AI and agents servers
- Downloads a week
- 45
- more than 37% of 1,538 AI and agents servers with a package
What its tools let an agent do: 19 read · 2 create · 5 change · 1 run or deploy
Install Parseable in Claude Code, Cursor or VS Code
Runs npx -y @parseable/parseable-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add parseable-mcp-server -- npx -y @parseable/parseable-mcp-server
What the publisher says
From the Parseable repository's README, as published. We do not edit it. Read it on GitHub
Parseable MCP Server
Model Context Protocol server for Parseable. 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.
Two transports:
Quickstart — stdio (local)
One command — interactive setup, detects Claude Desktop / Cursor, writes config files:
npx -y @parseable/parseable-mcp-server initRestart your MCP client. Tools appear. Done.
Scripted:
npx -y @parseable/parseable-mcp-server init \
--client claude-desktop \
--url https://your-parseable.example.com \
--api-key "$PARSEABLE_API_KEY"Supported --client values: claude-desktop, cursor.
Cursor Marketplace plugin
The repository also contains a native Cursor plugin manifest. Marketplace installs connect to https://mcp.parseable.com/mcp and read credentials from the environment.
Set these variables before starting Cursor:
export PARSEABLE_URL="https://your-parseable.example.com"
export PARSEABLE_API_KEY="your-api-key"
export PARSEABLE_MODE="self-hosted"PARSEABLEAPIKEY and PARSEABLEMODE are required by the Cursor plugin. Use PARSEABLEMODE=cloud and omit PARSEABLEURL for Parseable Cloud. Use PARSEABLEMODE=self-hosted with PARSEABLE_URL for self-hosted Parseable.
# Parseable Cloud
export PARSEABLE_MODE="cloud"
export PARSEABLE_API_KEY="your-cloud-api-key"
unset PARSEABLE_URLThen 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:
npx -y @parseable/parseable-mcp-server init --client cursorPlugin 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.
Quickstart — HTTP (hosted)
HTTP 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.
1. Set env vars
# .env
PORT=87872. Run
# From source
npm run build:all
node dist/server.js http
# Docker
docker build -t parseable-mcp-server .
docker run -p 8787:8787 --env-file .env parseable-mcp-server3. Connect from Claude
- Claude Desktop → Settings → Connectors → Add custom connector
- Name: Parseable
- URL: https://mcp.your-domain.com/mcp
- Header X-Parseable-URL: https://your-parseable.example.com
- Header X-API-Key: your Parseable API key
- Click Add → Connect
4. Connect from Claude Code
claude mcp add --transport http parseable https://mcp.your-domain.com/mcp --scope user \
--header "X-Parseable-URL: https://your-parseable.example.com" \
--header "X-API-Key: $PARSEABLE_API_KEY"5. Connect from Cursor / VS Code
{
"mcpServers": {
"parseable": {
"type": "http",
"url": "https://mcp.your-domain.com/mcp",
"headers": {
"X-Parseable-URL": "https://your-parseable.example.com",
"X-API-Key": "your-parseable-api-key"
}
}
}
}HTTP authentication
Each POST /mcp request requires X-API-Key and supports two modes:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Parseable: common questions
- Is Parseable MCP server safe?
- Yes, by our scan: it is graded A (89/100). Read the Parseable safety report
- How do I install Parseable?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Parseable need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Parseable maintained?
- The last commit was 74 days ago (2026-08-22). The latest release is v0.2.16.
- What can I use instead of Parseable?
- Servers from other publishers that do the same job: three.ws Marketplace MCP server.
- How does Parseable compare with other AI and agents MCP servers?
- safety score 89/100 (higher than 83% of 4,460 AI and agents servers); tools 27 (the typical AI and agents server has 6); tools that change things 19% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Parseable
Same job from other publishers: the closest match first, then the best rated.
- three.ws MarketplaceBrowse and discover the public three.ws agent marketplace and skills catalog. Read-only.not reviewedEstablishedA