Trace2MCP

Teach once. Run forever.

Trace2MCP compiles a successful AI-agent tool-call trace into a deterministic, inspectable, MCP-ready workflow.

An agent can discover a useful procedure once. Trace2MCP then validates the trace, infers data dependencies, deduplicates safe reads, builds a directed acyclic graph (DAG), and identifies work that can run concurrently.

Install

pip install trace2mcp

To run generated MCP servers, install the optional MCP dependency:

pip install "trace2mcp[mcp]"

Python 3.10 or newer is required.

Try it

trace2mcp inspect trace.json
trace2mcp compile trace.json --out build/my-workflow
trace2mcp benchmark trace.json --repetitions 3

Or use the Python API:

from trace2mcp import compile_trace, load_trace

trace = load_trace("trace.json")
workflow = compile_trace(trace, allow_side_effects=False)

print(workflow.to_dict())

The compile command produces a portable workflow.json, inert handler stubs, and a minimal MCP server skeleton. You provide the real tool implementations; observed trace outputs are never converted into executable code.

Why compile traces?

• Lower orchestration overhead: reuse a discovered procedure instead of planning the same tool path on every run.
• Dependency-aware execution: independent read-only calls can run in parallel.
• Fail-closed safety: writes and unknown operations are rejected unless explicitly allowed.
• Auditability: tool calls, references, dependencies, and scheduling remain visible as portable JSON.
• Provider-neutral design: the core compiler does not require a model or an API key.

Live demo

Use the free, browser-only Trace2MCP interactive demo or visit the Hugging Face Space.

The included demo uses synthetic outputs and recorded durations to explain the scheduler. Its speedup is educational, not a production performance claim.

Safety

Trace2MCP is a research prototype. Review generated workflows and implement authorization, validation, timeouts, and least-privilege access around real tools before production use.

Licensed under the MIT License.