LibreAI / AI Agents / mcp-agent
// agents · lastmile-ai/mcp-agent

mcp-agent

Simple workflow patterns for building effective agents on MCP.

★ 8.6k stars⑂ 893 forksApache-2.0updated 2026-01
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mcp-agent is an open-source ai agents project by lastmile-ai (lastmile-ai/mcp-agent on GitHub). It has 8,570 GitHub stars and 893 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 25 January 2026.

GitHub stars
8,570
Forks
893
License
Apache-2.0
Last updated on GitHub
25 January 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Pick a use case

    Start with one concrete task rather than a grand architecture.

  2. Fetch the source

    Clone the repo and check the examples folder for a quickstart.

  3. Configure it

    Install packages, set environment variables, and point it at your model.

  4. Run and iterate

    Execute the demo workflow, then adapt it to your own data.

// features

Why people love it

Workflow patterns

Chains, routers, and orchestrators.

MCP-native

Tools come through the protocol.

Lightweight

Patterns, not a heavy framework.

Python-first

Fits Python agent codebases.

Pragmatic docs

Focused on what works.

Apache-2.0

Open and commercially friendly.

Advertisement
// run it

Run it yourself

  1. Step 1 - Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/lastmile-ai/mcp-agent.git
    cd mcp-agent
  2. Step 2 - Install dependencies

    Create a virtual environment and install the requirements.

    python -m venv .venv && source .venv/bin/activate
    pip install -r requirements.txt
  3. Step 3 - Run an example

    Treat these as starting points - the README documents the exact commands.

    python examples/quickstart.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

lastmile-ai/mcp-agent is its home on GitHub, with 893 forks so far. The contributors tab and recent commits show how actively it is maintained.

Is mcp-agent free to use?

Yes - it is Apache-2.0 licensed, so it is free for commercial use with attribution.

Do I need a paid API to use it?

The code is free; you bring your own model provider, which may be a paid API or a local model.

How does it compare to bigger frameworks?

mcp-agent is deliberately small - patterns over platform. If you outgrow it, graduate to a full framework; if you value simplicity, it may be all you need.

How do I get started?

Follow the README quickstart, then browse the examples directory for patterns that match what you want to build.

// keep exploring

Similar tools

AI Agents

arcade-mcp

A Python framework for building MCP servers and agent tools.

★ 1.0k starsMIT
View guide →
AI Agents

agent-scan

Snyk's security scanner for AI agents, MCP servers and agent skills.

★ 3.1k starsApache-2.0
View guide →
Agents

yu-ai-agent

Chinese Java course: build AI agents with Spring AI, RAG, MCP, and tool calling.

★ 2.7k starsCustom
View guide →
AI Agents

agent-device

Mobile app automation and verification built for AI coding agents — CLI, MCP server, and Node API

★ 4.9k starsMIT
View guide →
AI Agents

fast-agent

Code, build and evaluate LLM agents with full MCP, Skills, ACP and A2A support.

★ 3.9k starsApache-2.0
View guide →
AI Agents

agent-framework

A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.

★ 13.9k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if mcp-agent is not the right fit.

Get mcp-agent

Free and open — grab the source, star the repo, and start creating.