API & Automation
REST API
Distill provides a local REST API on port 43821 (configurable). Enable the API server under Settings → API. Optional token authentication.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/health | Server status |
| GET | /v1/version | App version |
| GET | /v1/providers | Available AI providers |
| POST | /v1/providers | Switch provider |
| POST | /v1/suggest | Generate name suggestions |
| POST | /v1/rename | Rename files |
| GET | /v1/history | Rename history |
| POST | /v1/revert | Revert rename |
| GET/POST | /v1/rules | Read/set rules |
| GET/POST | /v1/settings | Read/set settings |
| GET/POST | /v1/watch | Manage folder watching |
| GET/POST | /v1/templates | Manage templates |
MCP Server
The MCP server (distill-mcp-server) enables AI assistants like Claude to control Distill. It ships inside the app bundle and communicates with the app via REST.
10 MCP tools: rename_files, suggest_names, revert_rename, get_rename_history, watch_folder, app_status, set_provider, get_rules, set_rules
Finder Extension
The FinderSync extension adds a “Rename with Distill” entry to the Finder context menu. Selected files are passed directly to Distill. The extension must be enabled in System Settings under Extensions.