# Mcp

> porticol-cli mcp: serve a workspace to an agent over MCP on standard input.

Canonical: https://porticol.app/docs/cli/mcp

[View as Markdown](https://porticol.app/docs/cli/mcp.md)

## Usage

```
porticol-cli mcp [--data-dir <path>] [--write]
```

## Mcp options

| Option | What it does |
| --- | --- |
| `--data-dir <path>` | the workspace to serve: PORTICOL_DATA_DIR, or the desktop's data folder, which it serves read-only |
| `--write` | offer the tools that change the workspace; without it every write tool is refused |
| `--create` | create the data folder when it is not there yet |

## Exit codes

| Code | Meaning |
| --- | --- |
| 0 | every request, assertion and threshold passed |
| 1 | an assertion, a schema check or a threshold failed, a flow stopped, or the run was stopped with Ctrl-C |
| 2 | a request could not be made |
| 3 | the command line, a file, the configuration, the token or a variable is wrong |
| 4 | the licence refused the run |
| 5 | the head document breaks the base document, at the level --fail-on names |
| 6 | the document has a lint finding of severity error |

## See also

- [this text, with examples](https://porticol.app/docs/cli.html)
- [a pipeline to copy](https://porticol.app/docs/automation.html)