MCP server for Shepherd - Debug your AI agents like you debug your code
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"shepherd-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 🐑 Shepherd MCP MCP (Model Context Protocol) server for Shepherd - Debug your AI agents like you debug your code. This MCP server allows AI assistants (Claude, Cursor, etc.) to query and analyze your AI agent sessions from multiple observability providers. ## Supported Providers - **AIOBS** (Shepherd backend) - Native Shepherd observability - **Langfuse** - Open-source LLM observability platform ## Installation ```bash pip install shepherd-mcp ``` Or run directly with uvx: ```bash uvx shepherd-mcp ``` ## Configuration ### Environment Variables #### AIOBS (Shepherd) - `AIOBS_API_KEY` (required) - Your Shepherd API key - `AIOBS_ENDPOINT` (optional) - Custom API endpoint URL #### Langfuse - `LANGFUSE_PUBLIC_KEY` (required) - Your Langfuse public API key - `LANGFUSE_SECRET_KEY` (required) - Your Langfuse secret API key - `LANGFUSE_HOST` (optional) - Custom Langfuse host URL (defaults to cloud.langfuse.com) ### .env File Support shepherd-mcp automatically loads `.env` files from the current directory or any parent directory. This means if you have a `.env` file in your project root: ```bash # .env # AIOBS AIOBS_API_KEY=aiobs_sk_xxxx # Langfuse LANGFUSE_PUBLIC_KEY=pk-lf-xxxx LANGFUSE_SECRET_KEY=sk-lf-xxxx LANGFUSE_HOST=https://cloud.langfuse.com ``` It will be automatically loaded when the MCP server starts. ### Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "shepherd": { "command": "uvx", "args": ["shepherd-mcp"], "env": { "AIOBS_API_KEY": "aiobs_sk_xxxx", "LANGFUSE_PUBLIC_KEY": "pk-lf-xxxx", "LANGFUSE_SECRET_KEY": "sk-lf-xxxx", "LANGFUSE_HOST": "https://cloud.langfuse.com" } } } } ``` ### Cursor Add to your `.cursor/mcp.json`: ```json { "mcpServers": { "shepherd": { "command": "uvx", "args": ["shepherd-mcp"], "env": { "AIOBS_API_KEY": "aiobs_sk_xxxx", "LANGFUSE_PUBLIC_KEY": "pk-lf-xxxx", "LANG…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.