@paretools/python

Structured, token-efficient Python tool output for AI agents. Up to 65% fewer tokens than raw CLI output.

Part of the Pare suite of MCP servers.

Tools (8)

Tool	Description
pip-install	Install packages, returns summary of installed items
mypy	Type-check diagnostics (file, line, severity, message)
ruff-check	Lint diagnostics (file, line, code, message)
pip-audit	Vulnerability report for installed packages
pytest	Run tests, returns structured pass/fail results
uv-install	Install packages via uv with structured summary
uv-run	Run a command in a uv-managed environment
black	Format code with Black, returns changed/unchanged files

Quick Start

npx -y @paretools/python

Add to your MCP client config:

{
  "mcpServers": {
    "pare-python": {
      "command": "npx",
      "args": ["-y", "@paretools/python"]
    }
  }
}

Example

mypy output:

{
  "success": false,
  "errors": [
    {
      "file": "app/main.py",
      "line": 15,
      "severity": "error",
      "message": "Argument 1 to \"process\" has incompatible type \"str\"; expected \"int\"",
      "code": "arg-type"
    }
  ],
  "errorCount": 1,
  "warningCount": 0,
  "noteCount": 0
}

Python Interpreter Resolution

Python-backed tools prefer the project-local virtual environment before falling back to global commands. When a tool needs Python, Pare checks for interpreters in this order from the requested path:

1. .venv/bin/python, .venv/bin/python3 (or .venv/Scripts/python.exe on Windows)
2. venv/ and env/ with the same platform-specific interpreter names
3. python
4. python3

Tools such as ruff-check, ruff-format, pytest, mypy, pip-install, pip-audit, and black also fall back from a missing console script to python -m <module>. Use pythonPath on ruff-check, ruff-format, pytest, and mypy when a project needs an explicit interpreter override.

All Pare Servers (244 tools)

Package	Tools	Wraps
@paretools/git	status, log, diff, branch, show, add, commit, push, pull, checkout	git
@paretools/test	run, coverage	pytest, jest, vitest, mocha
@paretools/npm	install, audit, outdated, list, run, test, init	npm
@paretools/build	tsc, build, esbuild, vite-build, webpack	tsc, esbuild, vite, webpack
@paretools/lint	lint, format-check, prettier-format, biome-check, biome-format	eslint, prettier, biome
@paretools/python	pip-install, mypy, ruff-check, pip-audit, pytest, uv-install, uv-run, black	pip, mypy, ruff, pytest, uv, black
@paretools/docker	ps, build, logs, images, run, exec, compose-up, compose-down, pull	docker, docker compose
@paretools/cargo	build, test, clippy, run, add, remove, fmt, doc, check	cargo
@paretools/go	build, test, vet, run, mod-tidy, fmt, generate	go, gofmt

Compatible Clients

Works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code / GitHub Copilot, Cline, Roo Code, Zed, Continue.dev, Gemini CLI, OpenAI Codex

Links

• Pare monorepo
• MCP protocol

License

MIT