Fast Agent

v1.0.0Coding Agentsstable

Code, Build and Evaluate agents - excellent Model and Skills/MCP/ACP Support

acpagentagent-frameworkagent-skillscli
Share:
3,790
Stars
0
Downloads
0
Weekly
0/5

What is Fast Agent?

Fast Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to code, build and evaluate agents - excellent model and skills/mcp/acp support

Code, Build and Evaluate agents - excellent Model and Skills/MCP/ACP Support

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Code, Build and Evaluate agents - excellent Model and Skills

Use Cases

Code, build, and evaluate AI agents with full MCP support.
Create agents with excellent model and skills integration.
evalstate

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx fast-agent

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Fast Agent

fast-agent is a Python framework and MCP-compatible agent runtime for building, composing, and evaluating AI agents with rich model and skill support. It lets you define agents with simple decorators, chain them into workflows (sequences, parallel fan-out, routers, evaluator-optimizers), and connect them to any MCP server over stdio, HTTP, or SSE transport. Developers use it to prototype and ship multi-agent systems that work with Anthropic, OpenAI, Google, Azure, Ollama, and other model providers without changing application code.

Prerequisites

  • Python 3.10 or later installed
  • uv package manager installed (https://github.com/astral-sh/uv)
  • API key for your chosen model provider (e.g. Anthropic, OpenAI, Google)
  • An MCP client such as Claude Desktop, or use fast-agent's own interactive CLI
  • Node.js (optional, for connecting to Node-based MCP servers)
1

Install fast-agent-mcp

Install the fast-agent-mcp package globally using the uv tool manager, or run it directly with uvx for a one-off execution.

uv tool install -U fast-agent-mcp
2

Create a fast-agent.secrets.yaml file

Store your model provider API keys in a secrets file in your project directory. This file is separate from the main config so you can safely version-control fast-agent.yaml without leaking credentials.

# fast-agent.secrets.yaml
anthropicApiKey: "sk-ant-..."
openaiApiKey: "sk-..."
3

Create a fast-agent.yaml configuration file

Define your MCP servers, model aliases, and other settings in fast-agent.yaml placed in your project root.

# fast-agent.yaml
mcp:
  servers:
    everything:
      transport: stdio
      command: npx
      args: ["-y", "@modelcontextprotocol/server-everything"]
default_model: claude-sonnet-4-6
4

Write a basic agent

Create a Python file defining your agent using the @fast.agent decorator. Agents can be interactive (waiting for user input) or run programmatically.

import asyncio
from fast_agent import FastAgent

fast = FastAgent("My Agent")

@fast.agent(instruction="You are a helpful assistant.")
async def main():
    async with fast.run() as agent:
        await agent.interactive()

if __name__ == "__main__":
    asyncio.run(main())
5

Run the agent

Execute your agent file with uv run, optionally overriding the model at the command line.

uv run agent.py --model=claude-sonnet-4-6
6

Launch a pre-built agent pack

Use the fast-agent CLI to run a pre-configured agent pack directly without writing code. The --pack flag downloads and runs a community-built agent bundle.

uvx fast-agent-mcp@latest --pack analyst --model haiku

Fast Agent Examples

Claude Desktop configuration

To expose a fast-agent as an MCP server, launch it with HTTP transport. Connect Claude Desktop to the running server using the streamable_http transport.

{
  "mcpServers": {
    "fast-agent": {
      "command": "uv",
      "args": ["run", "agent.py", "--transport", "http", "--port", "8001"],
      "env": {}
    }
  }
}

Prompts to try

Use these interactive commands inside a running fast-agent session to manage connections and skills.

- "Fetch the latest headlines from https://hf.co/mcp and summarize them"
- "Use the everything server tool to list available resources"
- "/connect @modelcontextprotocol/server-filesystem" (attach a new MCP server mid-session)
- "/skills" (list available agent skills)
- "Chain a URL fetcher and social media writer to create a tweet thread from http://example.com"

Troubleshooting Fast Agent

Agent fails to connect to an MCP server defined in fast-agent.yaml

Check that the command and args for the MCP server are correct and that the executable is on your PATH. Use the MCP Ping utility (fast-agent go --url <server-url>) to verify transport connectivity before wiring it into an agent.

Model provider authentication errors at runtime

Ensure fast-agent.secrets.yaml exists in the same directory where you run the agent, and that the key names match expected fields (anthropicApiKey, openaiApiKey, etc.). The secrets file takes priority over environment variables.

uvx command not found or fast-agent-mcp not resolving

Install uv first with: curl -LsSf https://astral.sh/uv/install.sh | sh. Then run: uv tool install -U fast-agent-mcp. Verify with: fast-agent --version

Frequently Asked Questions about Fast Agent

What is Fast Agent?

Fast Agent is a Model Context Protocol (MCP) server that code, build and evaluate agents - excellent model and skills/mcp/acp support It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Fast Agent?

Follow the installation instructions on the Fast Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Fast Agent?

Fast Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Fast Agent free to use?

Yes, Fast Agent is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "fast-agent": { "command": "npx", "args": ["-y", "fast-agent"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Fast Agent?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides