Pydantic Logfire MCP Server

This repository contains a Model Context Protocol (MCP) server with tools that can access the OpenTelemetry traces and metrics you've sent to Pydantic Logfire.

Remote MCP Server (Recommended)

Pydantic Logfire provides a hosted remote MCP server that you can use instead of running this package locally. This is the easiest way to get started with the Logfire MCP server.

To use the remote MCP server, add the following configuration to your MCP client.

Choose the endpoint that matches your Logfire data region:

• US region — logfire-us.pydantic.dev
• EU region — logfire-eu.pydantic.dev

For US region (logfire-us.pydantic.dev):

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

For EU region (logfire-eu.pydantic.dev):

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-eu.pydantic.dev/mcp"
    }
  }
}

[!NOTE] The remote MCP server handles authentication automatically through your browser. When you first connect, you'll be prompted to authenticate with your Pydantic Logfire account.

[!NOTE] If you want to run logfire-mcp locally, check the OLD_README.md file.

Configuration with well-known MCP clients

The examples below use the US region endpoint. Replace the URL with https://logfire-eu.pydantic.dev/mcp if you are using the EU region.

Configure for Cursor

Create a .cursor/mcp.json file in your project root:

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

Configure for Claude Code

Run the following command:

claude mcp add logfire --transport http https://logfire-us.pydantic.dev/mcp

Configure for Claude Desktop

Add to your Claude settings:

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

Configure for Cline

Add to your Cline settings in cline_mcp_settings.json:

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

Configure for VS Code

Make sure you enabled MCP support in VS Code.

Create a .vscode/mcp.json file in your project's root directory:

{
  "servers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

Configure for Zed

Create a .zed/settings.json file in your project's root directory:

{
  "context_servers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp"
    }
  }
}

Sandboxed Environments

If browser-based authentication is not available (e.g. in sandboxed environments), generate an API key with at least the project:read scope from your organization or project settings, then use it as a Bearer token:

{
  "mcpServers": {
    "logfire": {
      "type": "http",
      "url": "https://logfire-us.pydantic.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your-logfire-api-key>"
      }
    }
  }
}