Skip to content
This repository was archived by the owner on Mar 24, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
155 changes: 5 additions & 150 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,154 +1,9 @@
# 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.
> [!IMPORTANT]
> **This repository is archived.** The STDIO MCP server in this package is no longer being updated.
> We now have a remote MCP server, which allows us to iterate faster on tools and provide a better experience.

## Remote MCP Server (Recommended)
Read more in our [documentation](https://logfire.pydantic.dev/docs/how-to-guides/mcp-server/).

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`):
```json
{
"mcpServers": {
"logfire": {
"type": "http",
"url": "https://logfire-us.pydantic.dev/mcp"
}
}
}
```

For **EU region** (`logfire-eu.pydantic.dev`):
```json
{
"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](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:

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

### Configure for Claude Code

Run the following command:

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

### Configure for Claude Desktop

Add to your Claude settings:

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

### Configure for Cline

Add to your Cline settings in `cline_mcp_settings.json`:

```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](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_enable-mcp-support-in-vs-code).

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

```json
{
"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:

```json
{
"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:

```json
{
"mcpServers": {
"logfire": {
"type": "http",
"url": "https://logfire-us.pydantic.dev/mcp",
"headers": {
"Authorization": "Bearer <your-logfire-api-key>"
}
}
}
}
```
If you have any questions, reach out to us on [Slack](https://logfire.pydantic.dev/docs/join-slack/) or email us at [engineering@pydantic.dev](mailto:engineering@pydantic.dev).
155 changes: 5 additions & 150 deletions tests/README.md.jinja
Original file line number Diff line number Diff line change
@@ -1,154 +1,9 @@
# 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.
> [!IMPORTANT]
> **This repository is archived.** The STDIO MCP server in this package is no longer being updated.
> We now have a remote MCP server, which allows us to iterate faster on tools and provide a better experience.

## Remote MCP Server (Recommended)
Read more in our [documentation](https://logfire.pydantic.dev/docs/how-to-guides/mcp-server/).

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`):
```json
{
"mcpServers": {
"logfire": {
"type": "http",
"url": "https://logfire-us.pydantic.dev/mcp"
}
}
}
```

For **EU region** (`logfire-eu.pydantic.dev`):
```json
{
"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](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:

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

### Configure for Claude Code

Run the following command:

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

### Configure for Claude Desktop

Add to your Claude settings:

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

### Configure for Cline

Add to your Cline settings in `cline_mcp_settings.json`:

```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](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_enable-mcp-support-in-vs-code).

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

```json
{
"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:

```json
{
"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:

```json
{
"mcpServers": {
"logfire": {
"type": "http",
"url": "https://logfire-us.pydantic.dev/mcp",
"headers": {
"Authorization": "Bearer <your-logfire-api-key>"
}
}
}
}
```
If you have any questions, reach out to us on [Slack](https://logfire.pydantic.dev/docs/join-slack/) or email us at [engineering@pydantic.dev](mailto:engineering@pydantic.dev).
Loading