← Back to all projects

mcp-agent

Agents assembled from the patterns in Anthropic's "Building Effective Agents", with MCP as the only tool interface

Apache-2.0
Stars
8.6k
Forks
891
Open issues
150
Last commit
25 Jan 2026

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

8.5k8.6k

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.