# poetry

Runs Poetry commands and returns structured output. Supports install, add, remove, show, build, update, lock, check, and export actions.

Agent View of the PolicyLayer registry record for `poetry`. HTML page: https://policylayer.com/tools/io-github-dave-london-pare-python/poetry

## Facts

- Tool: `poetry`
- Server: Python (`Dave-London/Pare`) — https://policylayer.com/tools/io-github-dave-london-pare-python.md
- Homepage: https://github.com/Dave-London/Pare
- Risk category: Execute (High risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 12 (1 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | no | Working directory |
| `tree` | boolean | no | Show dependency tree, for show action (--tree) |
| `group` | string | no | Dependency group for install/add/remove (e.g. 'dev') |
| `action` | string | yes | Poetry action to perform |
| `dryRun` | boolean | no | Preview changes without applying, for install/add/remove (--dry-run) |
| `format` | string | no | Build output format for build action |
| `latest` | boolean | no | Show latest available version, for show action (--latest) |
| `output` | string | no | Output file for export action (-o FILE) |
| `compact` | boolean | no | Prefer compact output |
| `outdated` | boolean | no | Show only outdated packages, for show action (--outdated) |
| `packages` | array | no | Packages for add/remove actions |
| `exportFormat` | string | no | Export format for export action |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "poetry",
    "arguments": {
      "action": "<action>"
    }
  }
}
```

## Why poetry is rated High

This tool executes Poetry commands including package installation, addition, removal, and build operations. These actions modify the environment and dependency state. The 'remove' action could be destructive, and 'install'/'add' can introduce arbitrary packages.

From the tool's own definition: "Runs Poetry commands and returns structured output. Supports install, add, remove, show, build, update, lock, check, and export actions."

Risk signals: Accepts file system path (path) · High parameter count (13 properties)

## Use case

AI agents invoke poetry to trigger actions in Python. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call: builds kicked off, notifications sent, workflows started.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Python:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "poetry": {
      "limits": [
        {
          "counter": "poetry_rate",
          "window": "minute",
          "max": 10,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Python (13)

- `conda` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/conda.md
- `mypy` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/mypy.md
- `pip-install` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/pip-install.md
- `pyenv` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/pyenv.md
- `pytest` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/pytest.md
- `ruff-check` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/ruff-check.md
- `uv-install` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/uv-install.md
- `uv-run` — Execute — https://policylayer.com/tools/io-github-dave-london-pare-python/uv-run.md
- `black` — Read — https://policylayer.com/tools/io-github-dave-london-pare-python/black.md
- `pip-audit` — Read — https://policylayer.com/tools/io-github-dave-london-pare-python/pip-audit.md
- `pip-list` — Read — https://policylayer.com/tools/io-github-dave-london-pare-python/pip-list.md
- `pip-show` — Read — https://policylayer.com/tools/io-github-dave-london-pare-python/pip-show.md
- `ruff-format` — Read — https://policylayer.com/tools/io-github-dave-london-pare-python/ruff-format.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-dave-london-pare-python · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-dave-london-pare-python