Phare MCP Server

The Phare MCP server connects AI assistants like Mistral, Claude, and ChatGPT to your organization with the Model Context Protocol. Check which monitors are down, open an incident during an outage, or schedule a maintenance window, directly from your conversation. Applications connected to the MCP server act as you: they have the permissions of your role and only access your projects. No API key is needed, you log in to Phare and approve the application the first time you connect it. Use this URL to connect an application:

https://mcp.phare.io/mcp

Requirements

A Phare account with a verified email address.
Access to at least one project. Admins and the owner access every project, other members access the projects they are part of.
An application supporting remote MCP servers with OAuth, like the ones below.

Connecting an application

Select your application below for step-by-step instructions, with a link to its own MCP documentation.

Mistral Vibe

Add the MCP server

In Mistral Vibe (formerly Le Chat), open Connectors, click + Add Connector and switch to the Custom MCP Connector tab. Enter phare as the connector name and https://mcp.phare.io/mcp as the server URL, then click Connect.

Custom connectors are an administrator feature. On Free, Pro and Student plans, the account owner is the administrator.Check out the Mistral Vibe documentation for more details.

Vibe CLI

Add the MCP server

Run this command in your terminal:

vibe mcp add phare --url https://mcp.phare.io/mcp

Vibe opens your browser after adding the MCP server. Log in to Phare and approve the connection.

Check out the Vibe CLI documentation for more details.

Claude

Add the MCP server

In Claude, open Customize > Connectors, click + Add and choose Add custom connector. Enter Phare as the name and https://mcp.phare.io/mcp as the URL, then click Continue, Continue and Add.

On Team and Enterprise plans, an owner adds the connector in Organization settings > Connectors, then members click Connect next to Phare in Customize > Connectors.Check out the Claude documentation for more details.

Claude Code

Add the MCP server

Run this command in your terminal:

claude mcp add --transport http phare https://mcp.phare.io/mcp

In Claude Code, run /mcp, select phare and follow the steps in your browser to log in to Phare and approve the connection.

Check out the Claude Code documentation for more details.

ChatGPT

Add the MCP server

Open the ChatGPT plugins, click + and choose Add custom MCP server. Enter Phare as the name, a description, and https://mcp.phare.io/mcp as the URL. Choose OAuth as the authentication, accept the warning and click Create as a plugin.

ChatGPT asks you to log in to Phare the first time it uses a tool. Log in and approve the connection.

On business plans, your workspace policies can restrict custom MCP servers.Check out the ChatGPT documentation for more details.

Codex

Add the MCP server

Run this command in your terminal:

codex mcp add phare --url https://mcp.phare.io/mcp

The Codex IDE extension uses the same configuration.

Run this command, then log in to Phare in your browser and approve the connection:

codex mcp login phare

Check out the Codex documentation for more details.

Cursor

Add the MCP server

Add the MCP server to ~/.cursor/mcp.json, or to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "phare": {
      "url": "https://mcp.phare.io/mcp"
    }
  }
}

Restart Cursor, then open Customize > MCPs in the sidebar to log in to Phare and approve the connection.

Check out the Cursor documentation for more details.

VS Code

Add the MCP server

Run MCP: Add Server from the Command Palette and choose HTTP (HTTP or Server-Sent Events). Enter https://mcp.phare.io/mcp as the URL and phare as the server ID, then choose where to save it.

VS Code opens your browser when it starts the MCP server. Log in to Phare and approve the connection.

Check out the VS Code documentation for more details.

Zed

Add the MCP server

Open Settings > AI > MCP Servers, click Add Server and choose Add Remote Server. You can also add the MCP server to your settings file:

{
  "context_servers": {
    "phare": {
      "url": "https://mcp.phare.io/mcp"
    }
  }
}

Zed asks you to authenticate with the MCP server. Log in to Phare and approve the connection.

Check out the Zed documentation for more details.

Gemini CLI

Add the MCP server

Add the MCP server to ~/.gemini/settings.json:

{
  "mcpServers": {
    "phare": {
      "httpUrl": "https://mcp.phare.io/mcp"
    }
  }
}

In Gemini CLI, run /mcp auth phare, then log in to Phare in your browser and approve the connection.

Check out the Gemini CLI documentation for more details.

OpenCode

Add the MCP server

Run this command in your terminal:

opencode mcp add phare --url https://mcp.phare.io/mcp

Run this command, then log in to Phare in your browser and approve the connection:

opencode mcp auth phare

Check out the OpenCode documentation for more details.

Other applications

Enter https://mcp.phare.io/mcp as the URL of a remote MCP server (Streamable HTTP) in your application. The application registers itself with Phare and opens the Phare login page.Applications running on your computer, like command-line tools and desktop applications, work with Phare. Web applications must be allowed by Phare first: if yours isn’t, contact support.

Approving the connection

After you log in, Phare shows the name of the application, the site you will be sent to after approving, and your email address, organization and role. Click Approve to connect the application.

Only approve a connection you just started yourself. Phare shows a warning when the connection was started by an application on your computer, as any application on your computer can start one.

Using the MCP server

Once connected, ask your questions in plain words. For example:

“Which monitors are down in my Production project?”
“What was the uptime of the API monitor last month?”
“Open an incident on the status page for the slow checkout, and post an update saying we are investigating.”
“Schedule a maintenance window on Sunday from 2:00 to 4:00 for the database monitors.”
“Create an HTTP monitor for https://example.com checking every minute.”

The application calls whoami first to find your role and projects, then the tools it needs to answer.

If you have several projects, name the project in your request so the application uses the right one.

Permissions

The MCP server follows your role and your projects, so an application can never do more than you can in the dashboard:

Tools: The application only sees the tools your role can use. Viewers only see the tools reading data, responders also see the tools managing incidents and maintenance windows. Phare checks your permissions on every tool call, so a change to your role applies right away.
Projects: The application only accesses the projects you can access. Most tools act on one of them through their project_id argument.
Credentials: The MCP server can’t manage API keys, invitations, members, roles, single sign-on, the organization settings or billing. Use the dashboard for these.

Each tool tells the application whether it reads, creates, or changes and deletes data. Most applications ask for your confirmation before changing or deleting anything.

Tools

The tools run the endpoints of the Phare API, with the same arguments, validation and responses. Click a tool to see all its arguments in the API reference. The alert rules, monitors, reports, incidents, maintenance windows and status pages tools act inside a project and require a project_id argument: the ID of one of your projects, found with whoami or list_projects. List tools return 20 results per page by default, up to 100 with the per_page argument. The application gets the next results with the page argument.

Account

Tool	Description	Permission
`whoami`	Get your account, role, organization, permissions and the projects you can access. Called first.	Any role

Projects

Tool	Description	Permission
`list_projects`	List the projects you can access.	`projects:read`
`get_project`	Get a project by ID.	`projects:read`
`create_project`	Create a project.	`projects:write`
`update_project`	Update a project.	`projects:write`
`delete_project`	Delete a project with all its monitors, incidents, status pages and alert rules.	`projects:write`

Members

Tool	Description	Permission
`list_users`	List the members of your organization.	`members:read`
`get_user`	Get a member of your organization by ID.	`members:read`

Integrations

Tool	Description	Permission
`list_integrations`	List the integrations of an app, like Slack or Discord.	`integrations:read`
`get_integration`	Get an integration by ID.	`integrations:read`
`create_integration`	Create an integration.	`integrations:write`
`update_integration`	Update an integration.	`integrations:write`
`delete_integration`	Delete an integration not used by an alert rule.	`integrations:write`

Alert rules

Tool	Description	Permission
`list_alert_rules`	List the alert rules of the project and the organization-wide alert rules.	`alert_rules:read`
`get_alert_rule`	Get an alert rule by ID.	`alert_rules:read`
`create_alert_rule`	Create an alert rule.	`alert_rules:write`
`update_alert_rule`	Update an alert rule.	`alert_rules:write`
`delete_alert_rule`	Delete an alert rule.	`alert_rules:write`

Monitors

Tool	Description	Permission
`list_monitors`	List the monitors of the project.	`monitors:read`
`get_monitor`	Get a monitor by ID.	`monitors:read`
`get_monitor_report`	Get the uptime statistics of a monitor, over up to one year.	`monitors:read`
`create_monitor`	Create a monitor.	`monitors:write`
`update_monitor`	Update a monitor.	`monitors:write`
`pause_monitor`	Pause a monitor.	`monitors:write`
`resume_monitor`	Resume a paused monitor.	`monitors:write`
`delete_monitor`	Delete a monitor.	`monitors:write`

Reports

Tool	Description	Permission
`get_report`	Get the uptime statistics of all the monitors of the project, over up to one year.	`reports:read`

Incidents

Tool	Description	Permission
`list_incidents`	List the incidents of the project.	`incidents:read`
`get_incident`	Get an incident by ID.	`incidents:read`
`create_incident`	Create an incident.	`incidents:write`
`update_incident`	Update an incident.	`incidents:write`
`recover_incident`	Recover an incident now.	`incidents:write`
`delete_incident`	Delete an incident.	`incidents:write`

Incident updates

Tool	Description	Permission
`list_incident_updates`	List the updates of an incident.	`incidents:read`
`get_incident_update`	Get an incident update by ID.	`incidents:read`
`create_incident_update`	Post an incident update, an update with the `resolved` state recovers the incident.	`incidents:write`
`update_incident_update`	Update an incident update.	`incidents:write`
`delete_incident_update`	Delete an incident update.	`incidents:write`

Maintenance windows

Tool	Description	Permission
`list_maintenance_windows`	List the maintenance windows of the project.	`maintenance_windows:read`
`get_maintenance_window`	Get a maintenance window by ID.	`maintenance_windows:read`
`create_maintenance_window`	Schedule a maintenance window.	`maintenance_windows:write`
`update_maintenance_window`	Update a maintenance window.	`maintenance_windows:write`
`complete_maintenance_window`	Complete a maintenance window in progress.	`maintenance_windows:write`
`cancel_maintenance_window`	Cancel a scheduled or in progress maintenance window.	`maintenance_windows:write`
`delete_maintenance_window`	Delete a maintenance window.	`maintenance_windows:write`

Status pages

Tool	Description	Permission
`list_status_pages`	List the status pages of the project.	`status_pages:read`
`get_status_page`	Get a status page by ID.	`status_pages:read`
`get_status_page_current_status`	Get the current status of a status page.	`status_pages:read`
`create_status_page`	Create a status page.	`status_pages:write`
`update_status_page`	Update a status page.	`status_pages:write`
`delete_status_page`	Delete a status page.	`status_pages:write`

Disconnecting an application

Your applications are listed in the connected applications section of your user settings, with the site they send you to and when they were last active. Click the trash icon next to an application to disconnect it, it loses access to your account until you connect it again. Phare also disconnects all your applications when:

You change your password or your email address, or reset your password.
You enable or disable two-factor authentication.
Single sign-on is enabled or removed for your organization.

An application unused for 30 days must be connected again.

Security

You receive an email when an application is connected to your account, with the date, IP address and browser of the connection. If the connection is unexpected, disconnect the application, reset your password and contact support@phare.io right away. Phare uses the OAuth authorization code flow with PKCE. Access tokens expire after one hour, and only the known web applications and the applications running on your computer can connect.

Rate limiting

The MCP server is rate limited to 100 requests per minute across the organization. All members share the same limit, separate from the API rate limit.

If a tool is missing or a custom rate limit is needed, contact support. Phare can help find a solution that fits the use case.

Get Started

Uptime

Integrations

Automation

Requirements

Connecting an application

Approving the connection

Using the MCP server

Permissions

Tools

Account

Projects

Members

Integrations

Alert rules

Monitors

Reports

Incidents

Incident updates

Maintenance windows

Status pages

Disconnecting an application

Security

Rate limiting

​Requirements

​Connecting an application

​Approving the connection

​Using the MCP server

​Permissions

​Tools

​Account

​Projects

​Members

​Integrations

​Alert rules

​Monitors

​Reports

​Incidents

​Incident updates

​Maintenance windows

​Status pages

​Disconnecting an application

​Security

​Rate limiting

Requirements

Connecting an application

Approving the connection

Using the MCP server

Permissions

Tools

Account

Projects

Members

Integrations

Alert rules

Monitors

Reports

Incidents

Incident updates

Maintenance windows

Status pages

Disconnecting an application

Security

Rate limiting