Skip to main content

OpenTelemetry MCP Instrumentation

This library allows tracing of agentic workflows implemented with MCP framework mcp python sdk.

Installation

pip install opentelemetry-instrumentation-mcp

Example usage

from opentelemetry.instrumentation.mcp import McpInstrumentor

McpInstrumentor().instrument()

Privacy

By default, this instrumentation logs prompts, completions, and embeddings to span attributes. This gives you a clear visibility into how your LLM application tool usage is working, and can make it easy to debug and evaluate the tool usage.

However, you may want to disable this logging for privacy reasons, as they may contain highly sensitive data from your users. You may also simply want to reduce the size of your traces.

To disable logging, set the TRACELOOP_TRACE_CONTENT environment variable to false.

TRACELOOP_TRACE_CONTENT=false

Diagnostics

A failure inside this instrumentation never reaches your application: the traced call still goes out, and its result -- or its own exception -- is what the caller sees. Such a failure is logged at WARNING on the opentelemetry.instrumentation.mcp logger, with the stack at DEBUG.

Some of these failures sit on a per-message path (the stream writer), so a persistent one logs a line per MCP message. To quiet it without touching the rest of your logging:

import logging

logging.getLogger("opentelemetry.instrumentation.mcp").setLevel(logging.ERROR)

Metadata

Release files for opentelemetry-instrumentation-mcp 0.63.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opentelemetry-instrumentation-mcp 0.63.1
File Size Uploaded Provenance Actions
opentelemetry_instrumentation_mcp-0.63.1.tar.gz 138.2 kB With provenance Details for opentelemetry_instrumentation_mcp-0.63.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for opentelemetry-instrumentation-mcp 0.63.1
File Interpreter ABI Platform Actions
opentelemetry_instrumentation_mcp-0.63.1-py3-none-any.whl Python 3 none any Details for opentelemetry_instrumentation_mcp-0.63.1-py3-none-any.whl

Total release size: 155.0 kB

Release files / opentelemetry_instrumentation_mcp-0.63.1.tar.gz

Download URL opentelemetry_instrumentation_mcp-0.63.1.tar.gz
Size 138.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c87f328351b1869296def7bf9d307f58cd81e208fccde0ec2d9a5029c6ecf9aa
BLAKE2b-256 checksum
How to use checksums
007e03efdd4d2a3c2cdc93638280c92020845bfb470927fd9e34d8b24933277c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / opentelemetry_instrumentation_mcp-0.63.1-py3-none-any.whl

Download URL opentelemetry_instrumentation_mcp-0.63.1-py3-none-any.whl
Size 16.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1692bbbdb6f06201f246c0bebf725e47bf1689b28bf5d6b870a8c06572a51ee9
BLAKE2b-256 checksum
How to use checksums
30eb18daeffcc306436caaf7aaaf5071ac2f79e1a494cde34e5abe971dab8dfb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for opentelemetry-instrumentation-mcp 0.63.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for opentelemetry_instrumentation_mcp-0.63.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.63.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page