{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ncuhwdfwb94m","handle":"traceai-mcp-use","url":"https://wellknown.network/agents/traceai-mcp-use","links":{"self":"https://wellknown.network/agents/traceai-mcp-use/record.json","html":"https://wellknown.network/agents/traceai-mcp-use","markdown":"https://wellknown.network/agents/traceai-mcp-use/record.md","api":"https://wellknown.network/api/v1/agents/traceai-mcp-use","status":"https://wellknown.network/api/v1/agents/traceai-mcp-use/status","claim":"https://wellknown.network/agents/traceai-mcp-use/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/traceai-mcp-use/claim.json","badge":"https://wellknown.network/agents/traceai-mcp-use/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/traceai-mcp-use/history","tools":"https://wellknown.network/api/v1/agents/traceai-mcp-use/tools"},"ard":{"identifier":"urn:air::server:traceai-mcp-use","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"traceAI-mcp-use","summary":"OpenTelemetry tracing for mcp-use agents: one span per agent run, LLM call and tool call","description":"# traceAI-mcp-use\n\nOpenTelemetry tracing for [mcp-use](https://pypi.org/project/mcp-use/)\nagents (`mcp_use.MCPAgent`), sent to Future AGI.\n\n`FutureAGICallback` is a LangChain callback handler. You pass it to the\nagent with `MCPAgent(..., callbacks=[...])`. It records one span for each\nagent run, each LLM call and each tool call. It patches nothing, imports\nneither `langfuse` nor `traceai_mcp`, and sets no environment variables.\n\nThis package traces the agent loop. [`traceAI-mcp`](../mcp) (`traceai_mcp`)\nworks at the MCP transport level and is a different layer: a green\ntransport test does not show the agent run, its model calls or its tool\ncalls. See [Other tracing in the same process](#other-tracing-in-the-same-process).\n\n## Installation\n\n```bash\npip install traceAI-mcp-use\n```\n\nIt accepts `mcp-use>=1.7.1,<2`, `langchain-core>=1.0.0,<2` and\n`fi-instrumentation-otel>=1.1.0`, on Python `>=3.11,<3.14` (mcp-use itself\nrequires 3.11). The suite runs with mcp-use 1.7.1 (the latest release on\n2026-10-16) on Python 3.11, 3.12 and 3.13, and was run end to end against a\nreal model and a real stdio MCP server with mcp-use 1.7.1, langchain-core\n1.6.12, langchain-openai 1.7.2 and langgraph 1.2.16.\n\n## Usage\n\n```python\nfrom fi_instrumentation import register\nfrom fi_instrumentation.fi_types import ProjectType\nfrom mcp_use import MCPAgent, MCPClient\nfrom traceai_mcp_use import FutureAGICallback\n\ntrace_provider = register(project_type=ProjectType.OBSERVE, project_name=\"mcp-use-agent\")\n\nclient = MCPClient.from_dict({\"mcpServers\": {\"calculator\": {\"command\": \"python\", \"args\": [\"server.py\"]}}})\nagent = MCPAgent(\n    llm=llm,  # any LangChain chat model\n    client=client,\n    callbacks=[FutureAGICallback(tracer_provider=trace_provider)],\n)\nresult = await agent.run(\"What is 2 + 3?\")\n```\n\nPass the provider `register()` returns: `register()` does not set the\nglobal provider unless you ask it to, and without `tracer_provider` the\ncallback uses the global one. One callback can serve many a…","publisher":{"name":"Future AGI","url":null},"homepage":"https://docs.futureagi.com/docs/tracing","repository":"https://github.com/future-agi/traceAI/blob/dev/python/frameworks/mcp-use/CHANGELOG.md","version":"0.1.0","license":"Apache-2.0","protocols":["mcp"],"tags":["traceai","futureagi","opentelemetry","tracing","observability","llm","mcp-use","mcp"],"pricing":null,"endpoints":[{"url":"pypi:traceai-mcp-use","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"traceai-mcp-use","registry":"pypi","observedAt":"2026-11-04T02:26:33.247Z","publishedAt":"2026-11-01T22:39:45.962251Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"traceai-mcp-use","url":"https://pypi.org/project/traceai-mcp-use/","firstSeenAt":"2026-11-04T02:25:58.680Z","fetchedAt":"2026-11-04T02:25:58.680Z","normalizedAt":"2026-11-04T02:25:58.680Z"}]},"firstSeenAt":"2026-11-04T02:25:58.680Z","updatedAt":"2026-11-04T02:26:33.247Z"}