> 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

## MetricFire MCP Server

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

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.

<figure><img src="/files/R7kkLRIRmVlpVsXthlTf" alt=""><figcaption></figcaption></figure>

\
The full MCP token is only displayed once when it is created. Store it securely before leaving the page.

### 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)

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

These clients support custom HTTP headers. Configure the endpoint:

```
https://mcp.hostedgraphite.com/
```

and pass your token:

```
X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>
```

Refer to your client's MCP documentation for the location and format of its server configuration.

#### Claude

Claude's browser/UI configuration can connect using the MCP token in the server URL:

```
https://<MF-MCP-TOKEN>@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

After connecting, your MCP client can discover the tools currently exposed by Hosted Graphite.

#### Metrics

Tools are available for:

* Standard metrics search (by pattern)
* Tagged metrics search
* Busy metrics
* Invalid metrics
* Metric deletion

#### 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

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

#### 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 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.

#### Coming Soon: Dashboard Management

We’re working on adding support for Hosted Graphite HTTP Dashboard APIs through the MCP server. This will allow AI clients to reference metrics in your account and use them to create and manage Grafana dashboards directly from your agent workflow!

### 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 **<support@metricfire.com>**