
mcp-agent
Agents assembled from the patterns in Anthropic's "Building Effective Agents", with MCP as the only tool interface
What is mcp-agent?
mcp-agent makes a narrow bet: if every tool an agent needs arrives over MCP, the framework can be small. It handles the tedious half of that — opening, holding and closing connections to MCP servers — and then supplies the well-known compositions from Anthropic's "Building Effective Agents" as pieces you can nest: a router that picks a specialist, an orchestrator that plans and delegates, an evaluator that sends work back for another pass. The same agent can be published as an MCP server itself. For runs that must survive a crash it can execute on Temporal, which brings pause and resume at the cost of a service to operate.
What can you do with mcp-agent?
- Name the servers, not the connections — You list which MCP servers an agent may use and the framework opens, keeps and closes those connections around the run.
- Pick a specialist with a router — A router reads the request and sends it to whichever agent or server is meant to handle it, instead of putting every tool in one prompt.
- Plan, delegate, and gather the results — The orchestrator breaks a task into steps, hands each to an agent, and assembles what comes back — the pattern behind most "research this for me" agents.
- Send weak work back for another pass — An evaluator judges the output against criteria you set and returns it to the writer until it passes, rather than shipping the first attempt.
- Publish the agent as an MCP server — The finished agent can be exposed over MCP itself, so another agent — or a desktop client — can call it as a single tool.
- Survive a crash with durable execution — Running on Temporal lets a workflow pause, resume and recover from where it stopped, without changing how the agent is written.
Before you choose mcp-agent
- Durable execution is the reason to choose it over a smaller library, and it requires running Temporal — a separate service with its own operational weight — alongside your agent.
- The repository has been quiet since early 2026, so check recent commits and releases before building something long-lived on it.
Star history
27 Aug to 30 Oct · +47
Frequently asked questions
Is mcp-agent free for commercial use?
mcp-agent is released under the Apache-2.0 licence — OSI-approved open source, which permits commercial use.
How can mcp-agent be deployed?
mcp-agent is available as Self-hosted / Runs locally.