# genaispanmapper-mcp

A remote MCP server for standardizing OpenTelemetry GenAI spans. It detects missing provider attributes and produces consistent schemas for observability dashboards.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: clauxel
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clauxel/genai-span-mapper-mcp
- Updated: 2026-05-20
- HTML: https://affpapa.org/en/nevibecode/mcp/genaispanmapper-mcp

## What it does

The server standardizes generative AI telemetry so metrics dashboards remain consistent across different providers. It ingests OpenTelemetry span data, maps custom provider fields, and returns clean JSON structures.

It exposes five tools to coding agents: `map_genai_span_fields`, `normalize_provider_attributes`, `detect_missing_genai_attributes`, `issue_mapping_receipt`, and `export_observability_schema`. These handlers help inspect traces for omitted metadata, enforce mapping rules, and generate schema definitions for monitoring tools.

This is a commercial remote service hosted at `https://genaispanmapper.clauxel.com/mcp`. The public repository provides documentation rather than server source code, meaning active network access to the remote HTTP endpoint is mandatory.

## Requirements
- Remote server: `https://genaispanmapper.clauxel.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http genaispanmapper-mcp https://genaispanmapper.clauxel.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add genaispanmapper-mcp --url https://genaispanmapper.clauxel.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "genaispanmapper-mcp": {
            "url": "https://genaispanmapper.clauxel.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "genaispanmapper-mcp": {
            "type": "http",
            "url": "https://genaispanmapper.clauxel.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http genaispanmapper-mcp https://genaispanmapper.clauxel.com/mcp
```

## When to use it
- Standardize OpenTelemetry GenAI spans across multiple model providers
- Identify missing span attributes in generative AI traces
- Issue mapping receipts for trace transformation audits
- Export unified schema definitions for observability dashboards

## Example prompts
- Inspect this trace using `detect_missing_genai_attributes` and flag missing metadata.
- Normalize provider fields in this span with `normalize_provider_attributes`.
- Generate a dashboard schema definition using `export_observability_schema`.

## Similar
- [arize-instrumentation](https://affpapa.org/en/nevibecode/skills/arize-arize-instrumentation.md) — skill · 3400 installs
- [future-agi-platform](https://affpapa.org/en/nevibecode/skills/future-agi-platform.md) — skill · 308 installs
- [sentry-setup-ai-monitoring](https://affpapa.org/en/nevibecode/skills/sentry-setup-ai-monitoring.md) — skill · 3000 installs
- [sentry-instrument](https://affpapa.org/en/nevibecode/skills/sentry-instrument.md) — skill · 1800 installs
- [Heystack](https://affpapa.org/en/nevibecode/mcp/heystack.md) — MCP server
- [langfuse](https://affpapa.org/en/nevibecode/plugins/langfuse.md) — plugin · ★ 317

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md