# Project MCP server

> Run `elide mcp` over stdio to give AI agents tools to build projects, run files and snippets, and trace programs inside a project over the Model Context Protocol.

`elide mcp` gives AI agents tools to build projects, run code and trace programs inside a project, over stdio.

```bash
elide mcp
elide mcp --project PATH
```

Start it in a project directory, or pass `--project PATH`. To search these docs and report problems, connect the
[docs MCP server](https://elide.help/docs/mcp-docs) too.

## Configure a client

```json
{
  "mcpServers": {
    "elide": { "command": "elide", "args": ["mcp"] }
  }
}
```

## Tools

| Tool | Does |
| --- | --- |
| `build/inspect` | List the project's build tasks and their options without running them. |
| `build/run` | Start a build in the background and return a `buildId`. |
| `build/status` | Report the state of a build by `buildId`. |
| `build/cancel` | Cancel a running build. |
| `run/file` | Run a file in any supported language. |
| `run/snippet` | Run inline code in any supported language. |
| `insight/run` | Run a script with an [Insights](https://elide.help/docs/api-insight) script attached and return its events. |
| `elide` | Run any `elide` command. |

## Resources

| URI | Contains |
| --- | --- |
| `elide://advice/builtin` | Common commands and behavior. |
| `elide://insights/api` | TypeScript definitions for the Insights API. |
| The project's `elide.pkl` | The project manifest. |

## HTTP mode

`elide mcp --mode http` (default address `localhost:8125`) serves the legacy HTTP+SSE transport, not Streamable HTTP,
with a token from `ELIDE_MCP_TOKEN` (random if unset). Prefer stdio.