# Mantis SDK Documentation

> Agent-readable index for mantisdk and Insight documentation.
> Generated automatically from the public documentation pages.

## Downloadable Corpus

- [Original MDX files](/mantis-docs-mdx.zip): zip archive of every public `.mdx` docs file, preserving the docs directory structure.
- [Full documentation corpus](/llms-full.txt): all public docs concatenated into one Markdown-style text file.
- [Agent index](/llms.txt): this lightweight navigation file.

## High-Signal Entry Points

- [mantisdk](/): **OpenTelemetry-based distributed tracing for AI agents.**
- [Installation](/installation): Install the core mantisdk package:
- [Quickstart](/quickstart): Get Mantis SDK tracing working in 5 minutes.
- [Tracing Overview](/tracing): Mantis SDK tracing provides OpenTelemetry-based distributed tracing for AI agents. It enables you to capture the full execution flow of your agent, including LLM calls, tool executions, and custom logic.
- [Insight Export](/tracing/insight-export): Export traces to Mantis Insight for visualization and analysis.
- [Framework Integrations](/integrations): Mantis SDK provides auto-instrumentation for popular AI frameworks via [OpenInference](https://github.com/Arize-ai/openinference). This section covers setup and usage for each supported framework.
- [Insight Ingestion (SDK)](/integrations/insight-ingestion): Send traces and scores directly to Insight from external agent pipelines using the SDK ingestion helpers.
- [Mantis MCP Server](/integrations/mantis-mcp-server): The Mantis MCP server gives AI tools read-only access to Insight traces, observations, scores, and analytics through the Model Context Protocol. Use it with Cursor, Claude Desktop, or any MCP-compatible client that can launch a local stdio server.
- [API Reference](/reference): Complete API reference for Mantis SDK tracing module.
- [Insight CLI](/reference/insight-cli): Use the Insight CLI to operate an Insight project from the terminal. It talks only to the public REST API, so requests use the same authentication, project scoping, and rate limits as browser and SDK traffic.
- [Insight REST API](/reference/insight-rest-api): Fetch traces, observations, scores, and sessions from Mantis Insight via the public REST API.
- [Insight SQL API](/reference/insight-sql-api): Run read-only SQL queries directly against your ClickHouse analytics data.
- [Insight OTel Ingestion Semantic Conventions](/reference/insight-otel-ingestion): Insight accepts OpenTelemetry (OTLP) trace data and converts it into traces and observations. This page documents every span attribute the ingestion endpoint recognizes, how attributes are resolved across frameworks, and how observation types, usage, and costs are extracted.
- [Environment Variables](/reference/environment): Reference for all environment variables used by Mantis SDK.

## All Pages

- [mantisdk](/): **OpenTelemetry-based distributed tracing for AI agents.**
- [Installation](/installation): Install the core mantisdk package:
- [Quickstart](/quickstart): Get Mantis SDK tracing working in 5 minutes.
- [Examples](/examples): Complete working examples demonstrating Mantis SDK tracing with different frameworks.
- [DSPy Reasoning Agent](/examples/reasoning-agent): A chain-of-thought reasoning agent built with DSPy and Mantis SDK tracing.
- [Google ADK Research Assistant](/examples/research-assistant): A multi-tool research assistant built with Google ADK and Mantis SDK tracing.
- [Anthropic Task Planner](/examples/task-planner): A task management agent built with Anthropic Claude and Mantis SDK tracing.
- [Framework Integrations](/integrations): Mantis SDK provides auto-instrumentation for popular AI frameworks via [OpenInference](https://github.com/Arize-ai/openinference). This section covers setup and usage for each supported framework.
- [Anthropic Integration](/integrations/anthropic): Trace Anthropic Claude API calls with Mantis SDK, including messages, tool use, and token counts.
- [Claude Code SDK Integration](/integrations/claude-code-sdk): The Claude Code SDK (also known as Claude Agent SDK) provides a powerful framework for building AI agents with Claude. mantisdk provides seamless integration for tracing all Claude agent interactions.
- [DSPy Integration](/integrations/dspy): Trace DSPy modules, signatures, and chain-of-thought reasoning with Mantis SDK.
- [Google ADK Integration](/integrations/google-adk): Trace Google Agent Development Kit (ADK) agents with Mantis SDK.
- [Insight Ingestion (SDK)](/integrations/insight-ingestion): Send traces and scores directly to Insight from external agent pipelines using the SDK ingestion helpers.
- [Mantis MCP Server](/integrations/mantis-mcp-server): The Mantis MCP server gives AI tools read-only access to Insight traces, observations, scores, and analytics through the Model Context Protocol. Use it with Cursor, Claude Desktop, or any MCP-compatible client that can launch a local stdio server.
- [API Reference](/reference): Complete API reference for Mantis SDK tracing module.
- [Environment Variables](/reference/environment): Reference for all environment variables used by Mantis SDK.
- [Insight CLI](/reference/insight-cli): Use the Insight CLI to operate an Insight project from the terminal. It talks only to the public REST API, so requests use the same authentication, project scoping, and rate limits as browser and SDK traffic.
- [Insight OTel Ingestion Semantic Conventions](/reference/insight-otel-ingestion): Insight accepts OpenTelemetry (OTLP) trace data and converts it into traces and observations. This page documents every span attribute the ingestion endpoint recognizes, how attributes are resolved across frameworks, and how observation types, usage, and costs are extracted.
- [Insight REST API](/reference/insight-rest-api): Fetch traces, observations, scores, and sessions from Mantis Insight via the public REST API.
- [Insight SQL API](/reference/insight-sql-api): Run read-only SQL queries directly against your ClickHouse analytics data.
- [Semantic Conventions API](/reference/semconv): Reference for `mantisdk.tracing.semconv` module.
- [Tracing Module API](/reference/tracing): Complete API reference for `mantisdk.tracing`.
- [Tracing Overview](/tracing): Mantis SDK tracing provides OpenTelemetry-based distributed tracing for AI agents. It enables you to capture the full execution flow of your agent, including LLM calls, tool executions, and custom logic.
- [Async Support](/tracing/async-support): Mantis SDK provides full async/await support for tracing asynchronous code.
- [Auto-Instrumentation](/tracing/auto-instrumentation): Mantis SDK can automatically instrument popular AI frameworks to capture LLM calls without manual code changes.
- [Context Tagging](/tracing/context-tagging): Attach metadata -- like a call type, tags, or environment -- to every span created inside a code block, without touching each span individually.
- [Initialization](/tracing/initialization): Configure and initialize Mantis SDK tracing.
- [Insight Export](/tracing/insight-export): Export traces to Mantis Insight for visualization and analysis.
- [Semantic Conventions](/tracing/semantic-conventions): Mantis SDK provides semantic conventions for consistent attribute naming across traces.
- [Traces & Spans](/tracing/traces-and-spans): Learn how to create traces and spans to instrument your AI agent.

## Usage Guidance For Agents

- Use `/llms-full.txt` when you need the complete documentation corpus in one request.
- Use `/mantis-docs-mdx.zip` when you need the original MDX pages and directory layout.
- Use this `/llms.txt` file when you need a compact map of the docs site.
- Prefer the reference pages for exact commands, environment variables, API routes, and authentication rules.
- Never invent API keys or tokens. Use placeholders from the docs unless the user provides credentials out of band.