# `once mcp`

Expose Once's graph and memory queries to a coding agent.

## Synopsis

```text
once mcp [OPTIONS]
```

## Description

Speaks the Model Context Protocol over standard input and output so a coding harness can discover schemas and starters, validate and edit typed graphs, inspect or execute annotated scripts, run graph capabilities, and query project evidence without scraping prose. Mounts inspection tools by default; pass `--allow-run` to expose manifest editing, test, build, run, and runtime session tools.

## Options

| Flag | Value | Default | Description |
| --- | --- | --- | --- |
| `--workspace` | `<DIR>` |  | Workspace root the agent tools resolve targets against. Defaults to the value of the global `-C/--directory` flag (or the current directory). |
| `--allow-run` | (flag) |  | Advertise and allow state-changing editing and execution tools. |