Flare MCP Server

An MCP (Model Context Protocol) server that provides integration with Flare, an error reporting service for PHP applications.

Features

• Full integration with Flare API
• Manage projects (list, create, delete)
• View and manage errors (list, resolve, reopen)
• Access error occurrences with detailed stack traces
• User authentication and information retrieval

Installation

From npm (Recommended)

npm install -g flare-mcp-server

From Source

git clone https://github.com/jeroenzeegers/flare-mcp-server.git
cd flare-mcp-server
npm install
npm run build

Usage

With Claude Desktop

Add this configuration to your Claude Desktop settings:

{
  "mcpServers": {
    "flare": {
      "command": "npx",
      "args": ["flare-mcp-server"]
    }
  }
}

Available Tools

Authentication & Setup

1. flare_setup - Initialize the Flare client with your API token

   • Required: apiToken (string)

2. flare_get_user - Get authenticated user information

Context Management

3. flare_set_project_context - Set the current project context for subsequent operations

   • Required: projectId (string)

4. flare_clear_context - Clear the current project context

Project Management

5. flare_list_projects - List all projects

6. flare_create_project - Create a new project

   • Required: name (string)
   • Optional: stage (string)

7. flare_delete_project - Delete a project

   • Required: projectId (string)

Error Management

8. flare_list_errors - List errors for a project

   • Optional: projectId (string) - uses current context if not provided
   • Optional: page (number)

9. flare_resolve_error - Mark an error as resolved

   • Required: errorId (string)

10. flare_reopen_error - Reopen a resolved error

    • Required: errorId (string)

11. flare_list_error_occurrences - List occurrences of an error

    • Required: errorId (string)
    • Optional: page (number)

12. flare_get_error_occurrence - Get details of a specific error occurrence

    • Required: occurrenceId (string)

Available Resources

The server exposes contextual information through MCP resources:

• flare://context/current - Shows authentication status and active project
• flare://project/active - Details of the currently active project
• flare://errors/recent - Recent errors from the active project

Getting Started

1. Get your Flare API token from your Flare account settings

2. Initialize the client:

   Use tool: flare_setup
   apiToken: "your-api-token-here"

3. Verify connection:

   Use tool: flare_get_user

4. Start managing your projects and errors!

Example Workflow

Basic Workflow

# Setup
flare_setup apiToken="your-token"

# List all projects
flare_list_projects

# View errors in a project
flare_list_errors projectId="project-id"

Context-Aware Workflow (Recommended)

# Setup
flare_setup apiToken="your-token"

# Set project context
flare_set_project_context projectId="project-id"

# Now you can use tools without specifying project ID
flare_list_errors

# Resources automatically show context
# - flare://context/current shows active project
# - flare://errors/recent shows recent errors

# Get details about an error
flare_list_error_occurrences errorId="error-id"

# Resolve an error
flare_resolve_error errorId="error-id"

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start

License

ISC