mcp-agent
Python framework for building composable AI agents on the Model Context Protocol
Python teams building multi-step, tool-using agents who want to compose Anthropic-style workflow patterns on top of the MCP ecosystem, with a clean upgrade path to Temporal-backed durable execution.
Node/TypeScript-only shops, no-code builders who want a drag-and-drop agent canvas, or teams that need a fully managed hosted agent platform with SLAs today.
mcp-agent is an open-source Python framework from LastMile AI for building AI agents that speak the Model Context Protocol (MCP) natively. Rather than inventing yet another proprietary tool abstraction, it treats MCP as the shared substrate: any MCP server you already have (filesystem, GitHub, Slack, Postgres, browser, custom) becomes an immediately usable tool for your agent, with tools, resources, prompts, notifications, OAuth, sampling, and elicitation all supported end-to-end. On top of that base, the library ships composable implementations of the workflow patterns from Anthropic's 'Building Effective Agents' essay — parallel/map-reduce, router, intent classifier, orchestrator-worker, deep-research, evaluator-optimizer, and multi-agent swarm — so you can mix and match rather than adopt one monolithic architecture. The same agent code runs on plain asyncio for local development or on Temporal for durable, pause/resume, long-running workflows without changing the API. Provider support spans OpenAI, Anthropic, Google, Azure, and AWS Bedrock, and every agent can be re-exposed as its own MCP server so other MCP-aware clients (Claude Desktop, Cursor, Windsurf, custom apps) can call into it. Configuration lives in mcp_agent.config.yaml and mcp_agent.secrets.yaml, and OpenTelemetry tracing plus token accounting are built in for production observability. Typical users are Python developers and applied-AI teams who want a lightweight, code-first alternative to LangGraph or CrewAI that leans on the MCP ecosystem instead of custom connectors, and who value being able to run the same agent locally, in a container, or on a durable execution engine without rewrites.
This is the framework I reach for when I want an agent that actually uses the MCP servers I already run, rather than yet another bespoke tool wrapper. The pattern library reads like the Anthropic essay in executable form, and the asyncio-to-Temporal escape hatch is genuinely rare — most 'production-ready' agent frameworks make you rewrite to get durability. Python-only and rough edges around the hosted tier are the main caveats.
— The AI Tool Bible editorial team
Pros
- ✅ MCP-native from the ground up — any MCP server (filesystem, GitHub, Slack, browser, custom) is immediately usable without writing adapters
- ✅ Ships composable implementations of Anthropic's canonical agent patterns (router, orchestrator-worker, evaluator-optimizer, swarm, deep research)
- ✅ Durable execution via Temporal is opt-in — the same agent code runs on asyncio locally and pauses/resumes on Temporal in production
- ✅ Multi-provider: OpenAI, Anthropic, Google, Azure, and AWS Bedrock supported behind a common interface
- ✅ Agents can themselves be exposed as MCP servers, making them callable from Claude Desktop, Cursor, or any MCP-aware client
- ✅ Built-in OpenTelemetry tracing and token accounting for real observability, not just print-debugging
- ✅ Apache 2.0 licensed, active repo (8k+ stars) with regular releases and a healthy examples directory
Cons
- ⚠️ Python-only — no first-class TypeScript/JavaScript port for teams standardized on Node
- ⚠️ You still have to run and secure the underlying MCP servers yourself; the framework does not host them for you
- ⚠️ Durable execution requires operating a Temporal cluster (self-hosted or Temporal Cloud), which is meaningful infra overhead
- ⚠️ The hosted mcp-agent Cloud deployment product is still labeled Beta, so production-grade managed hosting is not fully mature
- ⚠️ Fewer prebuilt integrations and less community tutorial content than LangChain/LangGraph, so you will read source more often
- ⚠️ Rapidly evolving API surface — minor releases still land breaking changes as MCP itself matures
Use cases
Explore related
Compare with similar tools
All in MCP Servers →Airtable MCP Server
Model Context Protocol server that gives LLMs full read/write access to your Airtable bases.
Apple Notes MCP
Let Claude read your local Apple Notes over the Model Context Protocol.
AWS MCP Servers
Official AWS Labs collection of Model Context Protocol servers for connecting AI coding assistants and agents to AWS services and documentation.
Azure MCP Server
Official Microsoft MCP server that exposes 40+ Azure services to AI agents under the developer's own Entra ID credentials.
Blender MCP
Give Claude hands inside Blender — an MCP server for natural-language 3D modeling.
Brave Search MCP
Give any MCP client web and local search powered by the Brave Search API.