toolsmell

munzzyy/toolsmell

★ 1 stars Python Code/Dev Tools Updated today

Lint an MCP server's tool descriptions and JSON schemas for smells that make agents use the tools worse.

View on GitHub → 🔍 Audit Wallet Slippage →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "toolsmell": {
      "command": "uvx",
      "args": [
        "toolsmell"
      ]
    }
  }
}

Or install with pip: pip install toolsmell

README Excerpt

That's toolsmell run against [`examples/smelly-tools.json`](examples/smelly-tools.json), three tools handpicked to each trip a different smell: a description that's just "does stuff," a `search_orders` tool whose description tries to cover six jobs at once, and a `search_order`/`search_orders` pair an agent could

Topics

ai-agentsclideveloper-toolslintermcpstatic-analysis

toolsmell

Quick Install

README Excerpt

Topics

Related Code/Dev Tools Servers