Skip to main content
Glama

Distill MCP Server

Swift Platform License MCP juergenkoller-software/distill-mcp MCP server

Let Claude, Cursor, or any MCP client rename files for you — automatically, based on content.

This is the official Model Context Protocol bridge for Distill — a native macOS app that uses AI (Claude, OpenAI, Gemini, Ollama, or Apple Intelligence) to read your files and rename them with descriptive, consistent names. No more IMG_4521.jpg or Scan_003.pdf — get 250401 Invoice Telekom.pdf instead.

You need the Distill app installed and running. This MCP server is a stdio→HTTP bridge — the actual file analysis happens in the app. Get Distill at store.juergenkoller.software/apps/distill.


What you can do

"Claude, look at the 47 PDFs in ~/Downloads, rename them based on content, but show me the suggestions first."

The MCP server exposes 9 tools:

Tool

What it does

rename_files

Analyze file content with AI and rename with descriptive names

suggest_names

Suggest new names without renaming (preview mode)

revert_rename

Undo a previous rename

get_rename_history

Show the rename history (timestamps, before/after, AI provider used)

watch_folder

Add a folder to auto-monitoring (new files get renamed in the background)

app_status

Current state, AI provider, credits left, watched folders

set_provider

Switch AI provider — Claude, OpenAI GPT-4o, Gemini, Ollama (local), Apple Intelligence

get_rules

Show naming rules (date format, casing, categories, custom templates)

set_rules

Update naming rules

Distill reads PDFs, images (via OCR), Office documents, emails, HTML, RTF, and media files. It extracts date, category, description, sender, and amounts — then builds filenames using your configurable rules.


Related MCP server: Readedit

Installation

Prerequisites

  1. macOS 14 (Sonoma) or later

  2. Distill app installed and runningget it here (free, pay-per-use credits start at €1.99 / 100 renames)

  3. Swift 5.9+ (Xcode 15+) if building from source

Build from source

git clone https://github.com/juergenkoller-software/distill-mcp.git
cd distill-mcp
swift build -c release
# Binary: .build/release/DistillMCP

Pre-built binary

Grab the latest DistillMCP from Releases.


Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "distill": {
      "command": "/path/to/DistillMCP",
      "env": {
        "DISTILL_PORT": "22200",
        "DISTILL_TOKEN": "your-token-here"
      }
    }
  }
}

Find DISTILL_TOKEN in Distill → Settings → API & MCP.

Claude Code

claude mcp add distill /path/to/DistillMCP \
  --env DISTILL_PORT=22200 \
  --env DISTILL_TOKEN=your-token-here

Cursor / other MCP clients

Same pattern — DistillMCP is a stdio MCP server, configured via the two env vars above.


How it works

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────┐
│  Claude/Cursor │ ───────────────►  │  DistillMCP    │ ─────────────► │  Distill.app   │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 22200)  │
└────────────────┘                   └────────────────┘                └────────────────┘

The bridge reads JSON-RPC 2.0 requests from stdin, forwards them to Distill's local HTTP server at 127.0.0.1:22200/mcp, and writes responses back to stdout. All AI calls (Claude/OpenAI/Gemini/Ollama/Apple Intelligence), file reading (OCR, PDF extraction, Office parsing), credit tracking, and naming logic happen inside the Distill app.

This split lets the wire format stay open-source (audit it, sandbox it, run it through any MCP runtime) while the heavy lifting stays in the app.


Environment variables

Variable

Default

Description

DISTILL_PORT

22200

Port of Distill's local HTTP server

DISTILL_TOKEN

(none)

Bearer token from Distill Settings (required)

Errors and trace logs go to stderr so they don't pollute the JSON-RPC stdout channel.


About Distill

Distill is an AI file manager for macOS that automatically renames files based on content analysis. Highlights:

  • No subscription — free app, pay-per-use credits (100 free / 100 for €1.99 / 400 for €4.99 / 1,000 for €8.99)

  • Five AI providers — Claude, OpenAI GPT-4o, Google Gemini, Ollama (local, no API needed), Apple Intelligence

  • Reads everything — PDFs, images (OCR), Office docs, emails, HTML, RTF, media files

  • Local-only mode with Ollama — nothing leaves your Mac

  • Configurable NameBuilder — date formats, casing, categories, custom templates

  • Folder monitoring — drop files in, get them renamed automatically

  • REST API + Swagger UI — for non-MCP automation

  • MCP server (this repo) — for Claude/AI agents

  • Available on Mac App Store + direct download

Get Distill at store.juergenkoller.software


License

MIT — see LICENSE. Bridge is open source; the Distill app is commercial (free-to-try with pay-per-use credits).

Issues & support

Built by Juergen Koller Software GmbH.

Available Tools

9 tools
app_statusA

Gibt den aktuellen App-Status und Einstellungen zurück

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so description bears full burden. It discloses basic function but omits side effects, authentication needs, or whether it is read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single concise sentence in German, front-loaded and efficient. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While simple, the description does not detail the exact contents of 'status and settings'. However, given zero parameters and no output schema, it is largely complete for a status tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist, schema coverage is 100%. Description adds no parameter details, but none are needed beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns current app status and settings. It distinguishes from siblings which focus on specific features like rename history, rules, or provider settings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit usage guidance provided, but as a parameterless status check, its use case is implied. Lacks differentiation from siblings or cautionary notes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_rename_historyC

Zeigt die Umbenennungs-Historie

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximale Anzahl Einträge

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, and the description only mentions displaying history. It fails to disclose behavioral traits like read-only nature, authorization needs, or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. However, it is in German, which may reduce clarity for non-German-speaking AI agents.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of output schema, the description should explain the return format or content. It only states 'shows history' without details, leaving the agent uninformed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% for the single parameter 'limit', with a description in the schema. The tool description adds no additional meaning beyond that.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool shows rename history, using a specific verb and resource. However, it does not differentiate from sibling tools, though none seem directly similar.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. There is no mention of prerequisites or context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_rulesA

Zeigt die aktuellen Umbenennungsregeln (Format, Datum, Casing, Kategorien)

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. The verb 'shows' implies read-only, but it does not explicitly state that the tool is safe or has no side effects. For a getter, this is adequate but not thorough.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence, front-loaded with the primary action, and contains no fluff. Every word is relevant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description lists categories of rules (format, date, casing, categories), which gives a general idea of the response content. It could be more specific about the return structure, but for a simple getter, it is reasonably complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and schema coverage is 100%. The description does not need to add parameter information. The baseline for no parameters is 4, and the description does not detract from this.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it shows current renaming rules and lists specific aspects (format, date, casing, categories). This is a specific verb+resource, and it effectively distinguishes from sibling tools like set_rules and get_rename_history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not explicitly state when to use this tool versus alternatives, but the purpose is clear: use to view rules before setting or to check configuration. No exclusion or negative guidance is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rename_filesB

Benennt Dateien um: Analysiert den Inhalt mit KI und benennt die Dateien mit beschreibenden Namen um

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesAbsolute Dateipfade
templateNoOptionales Namenstemplate

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden. It mentions AI analysis and renaming but does not disclose potential destructiveness, permission requirements, or whether changes are reversible. The existence of revert_rename suggests history is kept, but this is not mentioned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, concise and front-loaded with the main action. However, it could benefit from structuring with more detail without sacrificing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema is present, so the description should explain return values or side effects. It does not mention what happens after renaming, nor does it leverage sibling tool context (e.g., history tracking). More completeness is needed for a mutation tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds minimal value beyond the schema, only implying that renaming is content-based. No additional semantic details are provided for either parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool renames files by analyzing content with AI to generate descriptive names. It uses a specific verb ('renames') and resource ('files'), and the method (AI analysis) is distinctive from sibling tools like suggest_names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, nor any prerequisites, exclusions, or conditions. The description lacks context for appropriate usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

revert_renameB

Macht eine Umbenennung rückgängig

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesPfad der umbenannten Datei

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It only says 'Undoes a rename' but does not disclose the mechanism (e.g., reverts to previous name using history), whether it is destructive, or what happens if the rename cannot be undone.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no superfluous words. However, it sacrifices completeness for brevity, so it does not fully earn a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple single-parameter tool, the description is minimal. It lacks details on input format, how the revert is resolved, and any limitations. With no output schema, more context would help.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% (one parameter with description). The tool description adds no extra meaning beyond the schema's 'path of the renamed file'. Baseline is 3, and no additional value provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Macht eine Umbenennung rückgängig' (Undoes a rename) clearly states the action and resource. It distinguishes from sibling tools like rename_files (which performs renames) and get_rename_history (which shows history).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, such as when to revert vs. manually renaming via rename_files. No prerequisites or context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_providerB

Wechselt den KI-Provider (Claude, OpenAI, Gemini, Ollama, Apple)

ParametersJSON Schema
NameRequiredDescriptionDefault
modelNoOptionales Modell (z.B. llama3.1, gpt-4o)
apiKeyNoAPI Key für den Provider
endpointNoOptionaler Endpoint
providerYesProvider-Name: Claude, OpenAI, Gemini, Ollama oder Apple

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description bears full responsibility for behavioral disclosure. It only states that the tool switches the provider but does not mention side effects, persistence, permissions, or impact on other operations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that efficiently communicates the core action. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple configuration tool, the description is somewhat adequate, but it does not mention the optional parameters (model, apiKey, endpoint) that can be set during the switch. With no output schema, more context on what happens after switching would help.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so each parameter is already explained well. The description adds minimal value beyond listing the provider names, which are already in the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: switching the AI provider. It lists the specific providers (Claude, OpenAI, Gemini, Ollama, Apple) which distinguishes it from sibling tools that deal with file renaming, rules, or app status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. There is no mention of prerequisites, context, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_rulesC

Ändert die Umbenennungsregeln

ParametersJSON Schema
NameRequiredDescriptionDefault
casingNokleinbuchstaben, Title Case, GROSSBUCHSTABEN, Wie von KI
formatNoNamensformat z.B. {datum}{sep}{kategorie}{sep}{beschreibung}
prefixNoPrefix vor dem Namen
suffixNoSuffix nach dem Namen
separatorNo- oder _ oder .
categoriesNoListe der Kategorien
dateFormatNoYYYY-MM-DD, DD.MM.YYYY, MM-DD-YYYY, YYYYMMDD, Kein Datum

TDQS

C2.6/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description carries the full burden. It merely states 'changes the renaming rules' without disclosing persistence, side effects, authorization needs, or any other behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with no wasted words. However, it could be slightly more structured to highlight key aspects.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of 7 parameters and no output schema or behavioral guidance, the description is severely lacking. It provides no context on what happens after successful invocation, validation, or potential errors.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so each parameter is already explained in the input schema. The description adds no extra semantic information, but the schema provides sufficient meaning for an agent.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Ändert' (changes) and the resource 'Umbenennungsregeln' (renaming rules), making the purpose unambiguous. It distinguishes from siblings like get_rules (read-only) and rename_files (apply rules).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. There is no mention of prerequisites, scenarios, or when not to use it, leaving the agent to infer from context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suggest_namesB

Schlägt neue Dateinamen vor ohne umzubenennen

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesAbsolute Dateipfade
templateNoOptionales Namenstemplate

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavior. It only states it suggests names without renaming, but gives no information about output format, whether it modifies anything, or any side effects. The agent cannot infer return structure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, very concise and to the point. However, it is in German which may reduce clarity for English-speaking agents.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description is insufficient. It does not explain what the tool returns (e.g., list of suggestions), how many, or any constraints. The tool likely needs more context for an agent to use it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both parameters. The tool description adds no additional parameter information beyond what is already in the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool suggests new file names and explicitly says it does not rename, distinguishing it from rename_files. However, it does not explicitly specify the resource (files) and the scope is slightly vague.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'without renaming' implies it is for getting suggestions before a rename, but there is no explicit guidance on when to use this tool versus alternatives like rename_files or get_rules.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

watch_folderC

Fügt einen Ordner zur Überwachung hinzu

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesAbsoluter Ordnerpfad
autoRenameNoAutomatisch umbenennen

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It does not mention side effects, required permissions, whether the monitoring is persistent, or how to stop it. This is a significant gap for a tool that likely has ongoing effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that lacks structure and is too brief to be useful. It under-specifies the tool rather than being efficiently concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations, output schema, and the tool's likely operational complexity (adding a folder for monitoring), the description is insufficient. It does not explain return values, how to verify success, or how the monitoring works.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear descriptions for both parameters. The description adds no additional meaning beyond the schema, resulting in a baseline score of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a clear verb+resource structure ('Adds a folder to monitoring'), making the tool's purpose understandable. It distinguishes itself from siblings like rename_files or set_rules, which perform different actions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, or any prerequisites or conditions for usage. The agent receives no context about appropriate scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 9 tool updatesv1.0.0
    • First observedapp_status
    • First observedget_rename_history
    • First observedget_rules
    • First observedrename_files
    • First observedrevert_rename
    • First observedset_provider
    • First observedset_rules
    • First observedsuggest_names
    • First observedwatch_folder

TDQS

A3.6/5.0

Scored across 9 tools

Disambiguation5/5

Each tool has a distinct purpose: status, history, rules (get/set), rename, revert, provider switch, suggestions, and folder watching. No overlapping functions.

Naming Consistency5/5

All tool names use consistent snake_case with clear verbs (get_, set_, rename_, revert_, suggest_, watch_) and follow a predictable pattern.

Tool Count5/5

9 tools cover the core functionality of an AI-powered file renaming application without being excessive or insufficient.

Completeness5/5

The tool set includes all essential operations: renaming, reverting, rule management, provider switching, suggestions, history, and folder watching. No obvious gaps.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    A powerful, security-hardened MCP server for intelligent file organization. Provides high-level atomic tools for organizing files into categories, detecting duplicates, extracting EXIF/ID3 metadata, scheduling automatic organization, and more — for use with Claude, Cursor, and Gemini CLI.
    4
    26
    29 npm
    44
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server that combines Read+Edit file operations into single tool calls. 80-95% fewer tool calls formulti-file refactoring across Claude, Cursor, Windsurf, and more.
    3
    10 npm
    3
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    MCP bridge for PDF Content Search — full-text PDF search with Apple Vision OCR across thousands of documents in under a second from Claude, Cursor, or any MCP client. Advanced filters (date, category, sender, amount), wildcards, boolean operators. Bridge open-source (MIT), PDF Content Search app is commercial with free iOS+Android companion scanner apps.
    84
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for FreezeText — OCR anything on your Mac screen from Claude, Cursor, or any MCP client. Freeze the screen and extract text via Apple Vision (videos, popups, protected PDFs), OCR a region or a base64 image, and manage a searchable capture history. 12 tools. Bridge open-source (MIT), FreezeText app is free.
    12
    1
    MIT