Pod

Yes, this is on purpose. Pod is built for agents, so the default page is plain HTML.
Human? View the normal website.
Agent? You probably prefer /mcp/opik-mcp-server/issues.md or /mcp/opik-mcp-server/issues.json, or Pod over MCP.

Reported issues for Opik MCP Server

Pod holds 24 of 29 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Opik MCP Server.

Most discussed

[Feature Request] Create Installation Wizard Script

Description

Create interactive installation wizard scripts for Unix and Windows to simplify initial setup.

Scripts to Create

Features

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 1 comment

[Feature Request] Add Docker Support

Description

Add Docker support for easy deployment, testing, and cross-platform compatibility.

Deliverables

  1. Dockerfile (multi-stage build)
  2. docker-compose.yml
  3. Docker Hub image
  4. Documentation

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add One-Click Install Support

Description

Add one-click install buttons and deep links for popular IDEs to simplify the installation process.

IDEs to Support

Implementation

Create install links and buttons that automatically configure the MCP server in supported IDEs.

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Improvement] Implement Granular Toolset Configuration

Description

Enhance the existing toolset configuration with more granular control over individual tools and experimental features.

Current State

Proposed Enhancements

  1. --disable-tools flag for excluding specific tools
  2. --enable-experimental flag for opt-in experimental features
  3. Document tool categories (read/write/admin)
  4. Tool-level permissions

Example Usag

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Read-Only Mode (Security)

Description

Add read-only mode to prevent mutation operations, providing a safer option for production deployments and untrusted environments.

Use Cases

Implementation

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Streamable HTTP Transport (Modern Alternative)

Description

Add Streamable HTTP transport as the modern, recommended alternative to SSE for network-based MCP server access.

Benefits

Implementation

Use SDK's StreamableHTTPServerTransport from @modelcontextprotocol/sdk/server/streamableHttp.js

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Replace Custom SSE Transport with Official SDK Implementation

Description

Replace the custom SSE transport implementation with the official SDK version for better maintainability and feature support.

Current State

Target State

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Upgrade to @modelcontextprotocol/sdk v1.18.2

Description

Upgrade from SDK v1.6.1 to v1.18.2 to access latest features, bug fixes, and official transport implementations.

Current State

Target State

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

Most recent

Add list-spans and get-span-by-id tools

Summary

The MCP server exposes tools for projects, traces, and stats, but has no tools for reading span-level data. This forces users to fall back to raw REST API calls (/api/v1/private/spans) for the most common debugging workflow: inspecting individual LLM calls, tool invocations, per-span timing, and token usage within a trace.

(Transferred from comet-ml/opik#6077)

Current state

The MCP server provides:

Read the thread · 2026-04-04 · open · external user · 0 comments

429 in streamable-http-transport.ts doesn't inspect Retry-After — incorrect retry behavior

Summary

Finding

Ran pitstop-check against the MCP transport layer:

src/transports/streamable-http-transport.ts:153 — 429 handled without Retry-After

Why it matters

In MCP transport, a 429 can mean different things:

When Retry-After is ignored, the transport retries quota exhaustion cases that can't recover until the window resets.

Example

curl -s -X POST https://web-production-273d3.up.railway

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/96) · 2026-04-02 · open · external user · 0 comments

### [Feature Request] Create Homebrew Formula

## Description
Create Homebrew formula for easy macOS installation.

## Implementation
Create a Homebrew tap: `comet-ml/homebrew-opik`

## Installation Experience
```bash
# Add tap
brew tap comet-ml/opik

# Install
brew install opik-mcp

# Use
opik-mcp --apiKey YOUR_KEY

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Rate Limiting

Description

Implement rate limiting using SDK's built-in express-rate-limit support.

Features

Implementation

The SDK already includes express-rate-limit in dependencies (v1.18.2).

import rateLimit from 'express-rate-limit';

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 minutes
  max: 100, // Limit each IP to 100

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/39) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Implement Caching Layer

## Description
Add caching layer for frequently accessed data to improve performance and reduce API calls.

## Data to Cache
- Project list
- Workspace information
- Prompt templates
- Trace statistics
- API responses (configurable)

## Implementation Options
1. **node-cache** (in-memory, simple)
2. **Redis** (external, scalable)
3. **lru-cache** (memory-efficient)

## Tasks
- [ ] Choose caching solution (node-cache recommended for simplicity)
- [ ] Implement cache layer utility
- [ ] Add cachin

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/38) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add OpenTelemetry Support

## Description
Instrument the server with OpenTelemetry for comprehensive observability.

## Metrics to Track
- Request duration
- Tool execution time
- Error rates
- API call latency
- Transport performance
- Resource usage

## Export to Opik (Dogfooding!)
Export traces back to Opik itself for self-monitoring.

## Implementation
```typescript
import { NodeSDK } from '@opentelemetry/sdk-node';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';

const sdk = n

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/37) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add Health Check Endpoint

## Description
Add comprehensive health check endpoints for monitoring and load balancing.

## Endpoints to Add
1. **/health** - Basic health check (existing, enhance)
2. **/health/ready** - Readiness probe
3. **/health/live** - Liveness probe

## Health Checks
Each endpoint should check:
- API connectivity to Opik
- Authentication status
- Resource availability
- Transport status

## Implementation
```typescript
app.get('/health', (req, res) => {
  res.json({ status: 'ok', timestamp: Date.now()

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/36) · 2025-10-01 · closed · outside contributor · 0 comments

### [Improvement] Add Structured Logging

## Description
Replace file-based logging with structured logging for better observability.

## Current State
- File-based logging to /tmp/opik-mcp.log
- Simple text format
- Limited metadata

## Target State
- Structured JSON logging
- Multiple log levels
- Rich metadata
- Log rotation
- Multiple outputs

## Implementation Options
1. **pino** (recommended - fast, low overhead)
2. **winston** (feature-rich)

## Tasks
- [ ] Choose logging library (pino recommended)
- [ ] Replace all logToFile() c

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/35) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Implement Prompts as MCP Prompts

## Description
Use MCP's native prompt system instead of exposing prompts as tools.

## Current State
- Prompts are exposed as tools (get-prompts, create-prompt, etc.)
- Not using MCP's native prompt capabilities

## Target State
- Use `server.setRequestHandler(ListPromptsRequestSchema, ...)`
- Use `server.setRequestHandler(GetPromptRequestSchema, ...)`
- Native MCP prompt protocol

## Benefits
- Better integration with MCP clients
- Follow MCP specification more closely
- Cleaner separation of 

[Read the thread](https://github.com/comet-ml/opik-mcp/issues/34) · 2025-10-01 · closed · outside contributor · 0 comments

### [Feature Request] Add Resource Subscriptions and Pagination

## Description
Implement resource subscriptions for real-time updates and proper cursor-based pagination.

## Part 1: Resource Subscriptions
Allow clients to subscribe to resource changes for real-time updates.

### Features
- Real-time updates via Server-Sent Events
- Subscribe to project changes
- Subscribe to trace updates
- Subscribe to prompt changes

### Implementation
```typescript
server.resource('opik://projects-list', {
  subscribe: true,
  handler: async () => { ... }
});

Part

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Add Developer Documentation

Description

Create comprehensive developer documentation for contributors.

Files to Create

  1. CONTRIBUTING.md - Contribution guidelines
  2. ARCHITECTURE.md - Technical architecture deep-dive
  3. docs/api-reference.md - Expand current API docs
  4. docs/troubleshooting.md - Common issues and solutions
  5. docs/migration-guide.md - Version upgrade guides

CONTRIBUTING.md Should Include

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Create Integration Guides

Description

Create comprehensive integration guides for all supported IDEs and platforms.

Guides to Create

  1. docs/integrations/cursor.md
  2. docs/integrations/vscode.md
  3. docs/integrations/windsurf.md
  4. docs/integrations/claude-desktop.md
  5. docs/integrations/docker.md
  6. docs/integrations/kubernetes.md

Each Guide Should Include

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Feature Request] Generate API Documentation

Description

Add comprehensive API documentation using TypeDoc and publish to GitHub Pages.

Implementation

Tasks

Scr

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Migrate from npm to pnpm

Description

Migrate package manager from npm to pnpm for better performance and consistency with MCP ecosystem.

Benefits

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Upgrade ESLint Configuration

Description

Upgrade to ESLint 9+ with stricter rules and modern flat config.

Changes

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

[Enhancement] Add End-to-End Tests

Description

Create end-to-end test suite for full integration testing.

Test Scenarios

  1. Full server startup (stdio transport)
  2. Full server startup (http transport)
  3. Complete tool execution flow
  4. Authentication flow
  5. Multi-client scenarios
  6. Error recovery

Tasks

Read the thread · 2025-10-01 · closed · outside contributor · 0 comments

The remaining reports are on the project's issue tracker.