Prometheus MCP Server
An API-complete MCP server to manage Prometheus-compatible backends.
Connector by tjhop · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/tjhop-prometheus-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: monitoring-observability
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 18 read · 3 write · 2 delete · 8 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Docker image
Tools by what they do 31
Read from the source code; the running server may list different tools.
Read 18 · Look things up without changing anything.
alertmanagersconfigdocs_listdocs_readdocs_searchflagslist_alertslist_ruleslist_storeslist_targetsmetric_metadatarunbooks_list
Show 6 more tools
runbooks_readruntime_infoseriestargets_metadatatsdb_statswal_replay_status
Write 3 · Create, change, send or run things.
build_infolabel_nameslabel_values
Delete 2 · Delete, drop, revoke or wipe things.
clean_tombstonesdelete_series
Not yet classified 8 · We could not tell from the name and description.
exemplar_queryhealthyqueryquitrange_queryreadyreloadsnapshot
Tools (31)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
alertmanagersGet overview of Prometheus Alertmanager discovery
build_infoGet Prometheus build information
clean_tombstonesRemoves the deleted data from disk and cleans up the existing tombstones. I/O- and CPU-intensive; prefer low-traffic periods and confirm with the user before calling.
configGet Prometheus configuration
delete_seriesDeletes data for a selection of series in a time range. Both start_time and end_time are required to prevent accidental deletion of all data. Deletion creates tombstones; run clean_tombstones or wait for compaction to reclaim disk space. Confirm the time range and matchers with the user before calling.
docs_listList of Official Prometheus Documentation Files.
docs_readRead the named markdown file containing official Prometheus documentation from the prometheus/docs repo
docs_searchSearch the markdown files containing official Prometheus documentation from the prometheus/docs repo
exemplar_queryExecute an exemplar query against the Prometheus datasource to find trace exemplars associated with metric samples
flagsGet runtime flags
healthyManagement API endpoint that can be used to check Prometheus health.
label_namesReturns the unique label names present in the block in sorted order by given time range and matches
label_valuesPerforms a query for the values of the given label, time range and matches
list_alertsList all active alerts
list_rulesList all alerting and recording rules that are loaded
Show 16 more tools
list_storesList all store API servers
list_targetsGet overview of Prometheus target discovery
metric_metadataReturns metadata about metrics currently scraped by the metric name.
queryExecute an instant query against the Prometheus datasource, returning one value per series at a single point in time
quitManagement API endpoint that can be used to trigger a graceful shutdown of Prometheus. Only call this when the user explicitly requests a shutdown.
range_queryExecute a range query against the Prometheus datasource, returning values over a time window; use for graphing and trend analysis
readyManagement API endpoint that can be used to check Prometheus is ready to serve traffic (i.e. respond to queries.)
reloadManagement API endpoint that can be used to trigger a reload of the Prometheus configuration and rule files. Safe; applies changes without downtime.
runbooks_listList the runbooks embedded in this server: guided workflows (Agent Skills) for common Prometheus tasks - investigating error rates and alert spikes, finding top CPU/memory/disk consumers, troubleshooting missing metrics or empty query results, health-checking Prometheus, reducing high-cardinality metrics, reviewing and drafting recording and alerting rules, and tuning Prometheus configuration. Call this and read the matching runbook with runbooks_read before starting any of these tasks.
runbooks_readRead the named runbook: a guided workflow (Agent Skill) for a common Prometheus task, expressed in terms of this server's tools. Follow its guidance when a user request matches a runbook's purpose; runbooks_list shows what is available.
runtime_infoGet Prometheus runtime information
seriesFinds series by label matches
snapshotcreates a snapshot of all current data into snapshots/<datetime>-<rand> under the TSDB's data directory and returns the directory as response. Safe, but confirm with the user before calling.
targets_metadataReturns metadata about metrics currently scraped by the target
tsdb_statsGet usage and cardinality statistics from the TSDB
wal_replay_statusGet current WAL replay status
Signals
- Stars
- 127
- Forks
- 25
- Open issues
- 4
- Contributors
- 8
- Last commit
- Oct 16, 2026 (13 days ago)
- Last release
- Apr 25, 2026 (6 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.tjhop/prometheus-mcp-server- Version
- 0.18.0
- Auth
- No auth
- Packages
- oci
ghcr.io/tjhop/prometheus-mcp-server:0.18.0 - License
- Apache-2.0
- Repository
- github.com/tjhop/prometheus-mcp-server
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Prometheus MCP Server. Agent Mart. https://agentmart.dev/connectors/tjhop-prometheus-mcp-server (last updated 2026-10-24)