{"id":"perses-mcp-server","name":"mcp-server","homepage":null,"repo_url":"https://github.com/perses/mcp-server","category":"api-gateway","subcategories":[],"tags":["mcp","perses","tooling","integration","automation","stdio","http-transport","go","self-hosted"],"what_it_does":"Provides a local Model Context Protocol (MCP) server for the Perses application, allowing MCP-capable LLM hosts to manage Perses resources (projects, dashboards, datasources, roles, variables, plugins). Supports stdio (local) and HTTP (remote/shared) transports and can run in read-only mode.","use_cases":["Connect an MCP-capable desktop IDE/client to a local Perses instance for reading and optionally writing Perses configuration/resources.","Enable standardized LLM-tool access to Perses dashboards, datasources, role bindings, and variables via MCP.","Share a single Perses-backed MCP endpoint to multiple clients using HTTP transport."],"not_for":["Production-grade multi-tenant exposure of Perses without careful network hardening (the MCP server is described as a local server; HTTP mode should be secured externally).","Use as a generic Perses API client outside MCP contexts (it is primarily an MCP server wrapper).","Environments that require strict, externally verifiable reliability/SLA claims (documentation does not provide these)."],"best_when":"You have a Perses instance running and an MCP-capable host (e.g., Claude Desktop, VS Code, Cursor, OpenCode) and you want tool-based automation of Perses resource management.","avoid_when":"You cannot adequately protect credentials/tokens used to reach Perses, or you cannot secure any HTTP transport exposure to the MCP server and Perses backend.","alternatives":["Directly call Perses APIs (if available in your environment) from your own service.","Use Perses CLI (e.g., percli) for workflows instead of MCP tool routing.","Build a small MCP wrapper that proxies to Perses REST endpoints (if you control the implementation)."],"af_score":60.5,"security_score":53.5,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:28:34.970553+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Basic authentication (username/password to Perses)","Bearer token authorization (token from percli whoami --show-token)"],"oauth":false,"scopes":false,"notes":"Auth is configured for the MCP server to authenticate to the Perses instance. Documentation describes Basic auth and Bearer token; it does not mention OAuth scopes or fine-grained MCP-level scopes."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"This is a self-hosted MCP server component; no pricing is described."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.5,"security_score":53.5,"reliability_score":28.8,"mcp_server_quality":80.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":75.0,"rate_limit_clarity":10.0,"tls_enforcement":55.0,"auth_strength":70.0,"scope_granularity":20.0,"dependency_hygiene":40.0,"secret_handling":75.0,"security_notes":"The README provides guidance to pass sensitive values via environment variables and supports TLS configuration for the Perses server connection (tls_config with ca_file and insecure_skip_verify). However, the documentation provided does not describe MCP-side auth, encryption requirements for HTTP transport, rotation, or security headers; also no mention of fine-grained scopes for MCP tool access. Dependency hygiene and version/security patching are not assessable from the provided data.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":50.0,"error_recovery":25.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["When running with read_only=true, write tools are disabled; agents attempting create/update operations should expect failures.","If using HTTP transport, ensure the MCP server and underlying Perses server are properly secured (documentation does not describe auth/allowlisting at the MCP transport layer beyond proxying Perses auth)."]}}