> For the complete documentation index, see [llms.txt](https://docs.hostedgraphite.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md). # MF MCP Server Connect AI assistants to interact with Hosted Graphite API's using natural-language prompts. #### Contents * [Create an MCP Token](#create-an-mcp-token) * [Connect an MCP Client](#connect-an-mcp-client) * [GitHub Copilot (VS Code)](#github-copilot-vs-code) * [Cursor, Claude Code, Cline, Windsurf](#cursor-claude-code-cline-windsurf) * [Claude](#claude) * [Available Tools](#available-tools) * [Metrics](#metrics) * [Graphite Render](#graphite-render) * [Alerts](#alerts) * [Dashboards](#dashboards) * [Notification Channels](#notification-channels) * [Scheduled Mutes](#scheduled-mutes) * [How It Works](#how-it-works) {% embed url="" %} The MetricFire MCP Server allows supported AI clients to interact directly with your Hosted Graphite account using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Once connected, clients such as GitHub Copilot, Cursor, Claude/Claude Code, etc. can use Hosted Graphite APIs for metric discovery, Graphite rendering, alert management, notification channels, scheduled mutes, and other monitoring workflows. The MCP server operates on data and resources in your Hosted Graphite account. Metrics must already be forwarded and stored in Hosted Graphite before they can be searched, rendered, or used for alerting. ### [Create an MCP Token](#create-an-mcp-token) In your Hosted Graphite account, navigate to **Add-Ons ⇒ MetricFire MCP Server** Create a token and select the permissions required by your MCP client: * **Read** – access metrics, renders, alerts, notification channels, scheduled mutes, and other supported resources. * **Write** – create or modify supported resources. * **Delete** – delete supported resources. We recommend using the minimum permissions required for your workflow.
\ The full MCP token is only displayed once when it is created. Store it securely before leaving the page. ### [Connect an MCP Client](#connect-an-mcp-client) The Hosted Graphite MCP endpoint is: ``` https://mcp.hostedgraphite.com/ ``` Configuration varies slightly depending on the MCP client. #### [GitHub Copilot (VS Code)](#github-copilot-vs-code) Open the VS Code Command Palette and select: **MCP: Open User Configuration** Add the MetricFire MCP Server object: ```json { "servers": { "mf-mcp-server": { "url": "https://mcp.hostedgraphite.com/", "headers": { "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN" } } } } ``` Save the configuration, start the MCP server from within VS Code, and interact with the agent using Copilot Chat. #### [Cursor, Claude Code, Cline, Windsurf](#cursor-claude-code-cline-windsurf) These clients support custom HTTP headers. Configure the endpoint: ``` https://mcp.hostedgraphite.com/ ``` and pass your token: ``` X-HostedGraphite-MCP-Token: ``` Refer to your client's MCP documentation for the location and format of its server configuration. #### [Claude](#claude) Claude's browser/UI configuration can connect using the MCP token in the server URL: ``` https://@mcp.hostedgraphite.com ``` **NOTE**: When using URL-based authentication, we highly recommend a **read-only token** unless write or delete access is specifically required. ### [Available Tools](#available-tools) After connecting, your MCP client can discover the tools currently exposed by Hosted Graphite. #### [Metrics](#metrics) Tools are available for: * Standard metrics search (by pattern\*) * Tagged metrics search * Busy metrics * Invalid metrics * Metric deletion #### [Graphite Render](#graphite-render) The Graphite Render API can be queried through MCP, with support for: * JSON * CSV * Raw data * PNG * SVG This allows MCP clients to locate metrics and retrieve or visualize their data over a specified time range. #### [Alerts](#alerts) AI assistants can work with your Hosted Graphite metrics to build meaningful **composite alerts using AND/OR logic**, making it easier to alert on service-level issues rather than individual metric thresholds. For example: *“Find the relevant CPU, memory, disk, and network metrics for my production servers and create a composite alert that emails me when multiple signals indicate a service-level issue.”* Alerting tools support: * Creating and updating alerts * Searching and retrieving alerts * Deleting alerts * Muting and unmuting alerts * Alert status and history * Composite alert criteria using AND/OR logic #### [Dashboards](#dashboards) AI clients can reference metrics stored in your Hosted Graphite account and use them to build, update, and manage Grafana dashboards using natural-language prompts. Instead of manually searching for metrics, creating panels, and configuring visualizations one at a time, you can ask your AI assistant to build a dashboard around a service, host, application, or infrastructure component you want to monitor. For example: *“Find the relevant CPU, memory, disk, and network metrics for my production servers and build a comprehensive infrastructure overview dashboard.”* Dashboard tools support: * Creating Grafana dashboards * Updating existing dashboards * Searching and retrieving dashboards * Deleting dashboards * Creating and configuring dashboard panels * Using Hosted Graphite metrics to build dashboards from natural-language prompts #### [Notification Channels](#notification-channels) MCP clients can work with Hosted Graphite notification channels (Email, Slack, PagerDuty, MS Teams, webhooks, etc.), including retrieving channels and associating them with alerts. Depending on token permissions, supported channels can also be created, updated, or deleted. #### [Scheduled Mutes](#scheduled-mutes) Scheduled mute tools allow MCP clients to create and manage recurring mute windows (e.g; weekends). Scheduled mutes are separate resources that can be associated with alerts through the Alert API. ### [How It Works](#how-it-works) The MetricFire MCP Server provides an MCP interface to supported Hosted Graphite APIs. The connected AI client selects the appropriate MCP tool based on the request and executes it using the permissions associated with your MCP token. The MCP integration does not replace your existing metric collection. Continue sending data to Hosted Graphite using your existing agents, integrations, or supported protocols. For more details about the underlying APIs, see the [Hosted Graphite API documentation](https://docs.hostedgraphite.com/api-guides) and if you need help connecting an MCP client, contact us at: MCP is not currently available for users that have enable the Hosted Graphite Add-on from the Heroku Marketplace. Contact us to learn how to migrate your Heroku HG account(s) to a dedicated HG account and take advantage of all available features like MCP and Logging.