{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_sdr59yevfxaj","handle":"msrashed-prometheus-mcp-server","url":"https://wellknown.network/agents/msrashed-prometheus-mcp-server","links":{"self":"https://wellknown.network/agents/msrashed-prometheus-mcp-server/record.json","html":"https://wellknown.network/agents/msrashed-prometheus-mcp-server","markdown":"https://wellknown.network/agents/msrashed-prometheus-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/msrashed-prometheus-mcp-server","status":"https://wellknown.network/api/v1/agents/msrashed-prometheus-mcp-server/status","claim":"https://wellknown.network/agents/msrashed-prometheus-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/msrashed-prometheus-mcp-server/claim.json","badge":"https://wellknown.network/agents/msrashed-prometheus-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/msrashed-prometheus-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/msrashed-prometheus-mcp-server/tools"},"ard":{"identifier":"urn:air::server:msrashed-prometheus-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"msrashed-prometheus-mcp-server","summary":"Read-only Prometheus/Thanos MCP server for metrics querying, cardinality analysis, and monitoring","description":"# Prometheus MCP Server\n\nA read-only Model Context Protocol (MCP) server for [Prometheus](https://prometheus.io/), enabling AI agents like Claude to query metrics, investigate alerts, and analyze monitoring data safely.\n\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-1.24.0+-green.svg)](https://github.com/anthropics/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Features\n\n- **Read-Only Safety**: All operations are read-only. No modifications to Prometheus configuration or data\n- **Comprehensive Query Support**: Execute PromQL instant and range queries\n- **Metadata Discovery**: List metrics, labels, and series\n- **Target Monitoring**: View scrape targets and their health\n- **Alert Investigation**: List active alerts and alert rules\n- **Configuration Inspection**: View Prometheus configuration and runtime info\n- **Multiple Auth Methods**: Support for Bearer tokens and Basic authentication\n- **Type-Safe**: Full type hints for Python 3.12+\n\n## Installation\n\n### Using uv (Recommended)\n\n```bash\n# Clone the repository\ngit clone <repository-url>\ncd prometheus-mcp-server\n\n# Install with uv\nuv pip install -e .\n\n# Or install from PyPI (when published)\nuv pip install prometheus-mcp-server\n```\n\n### Using pip\n\n```bash\npip install prometheus-mcp-server\n```\n\n### Using pipx (for CLI usage)\n\n```bash\npipx install prometheus-mcp-server\n```\n\n## Quick Start\n\n### 1. Set Environment Variables\n\n```bash\n# Prometheus server URL (required)\nexport PROM_URL=\"http://localhost:9090\"\n\n# Optional: Bearer token authentication\nexport PROM_TOKEN=\"your_bearer_token\"\n\n# Optional: Basic authentication\nexport PROM_USERNAME=\"admin\"\nexport PROM_PASSWORD=\"secret\"\n\n# Optional: Timeout and SSL settings\nexport PROM_TIMEOUT=\"30\"\nexport PROM_VERIFY_SSL=\"true\"\n```\n\n### 2. Run the Server\n\n```bash\n# Using stdio transport (default, for Claude Desktop)…","publisher":null,"homepage":"https://github.com/msalah-eg/prometheus-mcp-server","repository":"https://github.com/msalah-eg/prometheus-mcp-server","version":"0.3.0","license":"MIT","protocols":["mcp"],"tags":["ai","llm","mcp","metrics","model-context-protocol","monitoring","observability","prometheus"],"pricing":null,"endpoints":[{"url":"pypi:msrashed-prometheus-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"msrashed-prometheus-mcp-server","registry":"pypi","observedAt":"2026-11-03T19:31:05.272Z","publishedAt":"2026-03-06T01:36:47.109231Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"msrashed-prometheus-mcp-server","url":"https://pypi.org/project/msrashed-prometheus-mcp-server/","firstSeenAt":"2026-09-10T07:20:30.342Z","fetchedAt":"2026-11-03T19:29:57.180Z","normalizedAt":"2026-11-03T19:29:57.180Z"}]},"firstSeenAt":"2026-09-10T07:20:30.342Z","updatedAt":"2026-11-03T19:31:05.272Z"}