# Introduction

CLI that turns MCP servers into terminal commands.

## Why?

Companies invested years building MCP server integrations. 5,800+ servers, 10,000+ in production, 97M+ monthly SDK downloads. All that work exposes structured APIs over a standard protocol. [**Why MCP on the command line?**](https://mcp.avelino.run/why-mcp-cli) explains why this matters and how `mcp` lets you reuse all of it from your terminal.

[**MCP servers are draining your hardware**](https://mcp.avelino.run/mcp-servers-are-draining-your-hardware) — Every MCP client spawns all backend processes at startup and keeps them alive forever. We built lazy initialization and adaptive idle shutdown so the proxy only keeps alive what you're actually using.

## First steps

Are you new to `mcp`? Start here:

* [**Getting started**](https://mcp.avelino.run/first-steps/getting-started) — Install, configure your first server, call your first tool. 5 minutes from zero to working.
* [**Tutorial**](https://mcp.avelino.run/first-steps/tutorial) — A hands-on walkthrough that covers everything you need to use `mcp` day-to-day.

## Guides

Focused explanations for specific topics:

* [**Configuration**](https://mcp.avelino.run/guides/configuration) — Config file format, environment variables, server types.
* [**Authentication**](https://mcp.avelino.run/guides/authentication) — OAuth, API tokens, service-specific setup.
* [**Registry**](https://mcp.avelino.run/guides/registry) — Finding and adding servers from the MCP registry.
* [**Scripting**](https://mcp.avelino.run/guides/scripting) — Using `mcp` in shell scripts, piping, CI/CD.
* [**Proxy mode**](https://mcp.avelino.run/guides/proxy-mode) — Expose all servers as a single MCP endpoint for LLM tools.
* [**Audit logging**](https://mcp.avelino.run/guides/audit-logging) — Track every operation with queryable logs and real-time streaming.

## Reference

Technical details and complete specifications:

* [**CLI reference**](https://mcp.avelino.run/reference/cli) — Every command, flag, and option.
* [**Config file reference**](https://mcp.avelino.run/reference/config-file) — Full `servers.json` specification.
* [**Environment variables**](https://mcp.avelino.run/reference/environment-variables) — All supported env vars.
* [**Architecture**](https://mcp.avelino.run/reference/architecture) — How the codebase is organized.

## How-to

Recipes for common tasks:

* [**Supported services**](https://mcp.avelino.run/how-to/services) — Setup guides for Sentry, Slack, Grafana, GitHub, and more.
* [**Troubleshooting**](https://mcp.avelino.run/how-to/troubleshooting) — Common errors and how to fix them.