Better Agents

v1.0.0Coding Agentsstable

Standards for building agents, better

agent-frameworkagent-testingai-agentsclidev-tool
Share:
1,521
Stars
0
Downloads
0
Weekly
0/5

What is Better Agents?

Better Agents is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to standards for building agents, better

Standards for building agents, better

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

Features

  • Standards for building agents, better

Use Cases

Follow standards for building better AI agents.
Test agents with dev tools and testing frameworks.
langwatch

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx better-agents

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 Better Agents

Better Agents is a CLI and framework scaffolding tool from LangWatch that establishes opinionated standards for building, testing, and observing AI agents. It generates project structures complete with AGENTS.md documentation, integrates with popular agent frameworks including Agno, Mastra, and LangGraph, supports multiple coding assistants (Claude Code, Cursor, Kilocode), and ships with scenario-based testing, prompt versioning, and full observability instrumentation. Teams use it to bootstrap production-ready agent projects with consistent standards rather than starting from scratch.

Prerequisites

  • Node.js 18 or later with npm or npx available
  • An LLM provider API key (OpenAI, Anthropic, or another supported provider)
  • A coding assistant (Claude Code, Cursor, or Kilocode CLI) if using assistant integrations
  • An MCP-compatible client for MCP server mode
1

Install Better Agents globally

Install the CLI globally so you can use the better-agents command from any directory.

npm install -g @langwatch/better-agents
2

Initialize a new agent project

Run the init command in the directory where you want your agent project. The interactive CLI will guide you through language, framework, coding assistant, LLM provider, and API key selection.

better-agents init my-agent-project
cd my-agent-project
3

Select your agent framework

During initialization, choose from supported frameworks: Agno, Mastra, or LangGraph. The scaffolder generates framework-specific boilerplate and testing setup.

4

Review the generated AGENTS.md

Better Agents generates an AGENTS.md file that documents your agent's architecture, tools, and behaviors. This file serves as the source of truth for your coding assistant when working on the project.

5

Disable telemetry if desired

By default, Better Agents collects anonymous usage telemetry. Set the environment variable to opt out.

export BETTER_AGENTS_TELEMETRY=0
6

Add to MCP client configuration

To use Better Agents as an MCP server within Claude Desktop, add it to your client config.

{
  "mcpServers": {
    "better-agents": {
      "command": "npx",
      "args": ["@langwatch/better-agents"],
      "env": {
        "BETTER_AGENTS_TELEMETRY": "0"
      }
    }
  }
}

Better Agents Examples

Client configuration

claude_desktop_config.json entry for Better Agents MCP server with telemetry disabled.

{
  "mcpServers": {
    "better-agents": {
      "command": "npx",
      "args": ["@langwatch/better-agents"],
      "env": {
        "BETTER_AGENTS_TELEMETRY": "0"
      }
    }
  }
}

Prompts to try

Tasks you can perform with Better Agents through Claude or the CLI.

- "Initialize a new LangGraph agent project with Python and Claude Code integration"
- "Generate scenario-based tests for my customer support agent"
- "Set up observability instrumentation for my Mastra agent"
- "Show me the AGENTS.md template for an Agno-based research agent"
- "Create a prompt versioning setup for my multi-step reasoning agent"

Troubleshooting Better Agents

better-agents command not found after global install

Run `npm install -g @langwatch/better-agents` again and check that your npm global bin directory is on your PATH. Run `npm bin -g` to find the path and add it to ~/.zshrc or ~/.bashrc.

Framework selection does not generate expected boilerplate

Ensure you are using the latest version of the package with `npm install -g @langwatch/better-agents@latest`. Framework support is actively developed and earlier versions may have incomplete scaffolding for some frameworks.

Coding assistant integration does not pick up the generated AGENTS.md

The AGENTS.md file must be in the root of the project directory. For Claude Code, it is automatically discovered. For Cursor, you may need to add it as a project rule file in Cursor settings.

Frequently Asked Questions about Better Agents

What is Better Agents?

Better Agents is a Model Context Protocol (MCP) server that standards for building agents, better It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Better Agents?

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

Which AI clients work with Better Agents?

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

Is Better Agents free to use?

Yes, Better Agents is open source and available under the MIT 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": { "better-agents": { "command": "npx", "args": ["-y", "better-agents"] } } }

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

Read the full setup guide →

Ready to use Better Agents?

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