Loading ToolBench

Reading the current corpus…

local-addon-mcp-server MCP server · C · ToolBench

← Browse

local-addon-mcp-server

github.com/jpollock/local-addon-mcp-server

MCP (Model Context Protocol) server for Local, enabling AI tools like Claude Code to manage WordPress development sites

2026-07-28+STREAMABLE_HTTP24 tools

60/100

Definition Quality81

Protocol Readiness48

Supportability34

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence · evidence: Streamable HTTP

Current-spec patterns detected

Summary

24 tools with consistent verb-noun naming (list_, get_, create_, delete_, etc.) and complete input schemas. Descriptions are present but brief (avg ~80 chars, below the 194-char baseline). All parameters have type definitions and descriptions. However, output schemas are not documented in the source code, and error handling guidance is minimal. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications. Parameter descriptions lack format constraints and validation rules. Missing dependency hints and recovery guidance.

Tools (24)

change_php_versionwriteauthsource verified82/100

Change site PHP version

clone_sitewriteauthsource verified82/100

Clone an existing WordPress site to create a copy with a new name

create_sitewriteauthsource verified83/100

Create a new WordPress site in Local. The site will be created and started automatically. Optionally create from an existing blueprint.

delete_sitedestructiveauthsource verified85/100

Delete a WordPress site. Requires confirm=true as a safety measure.

export_databaseread onlyauthsource verified80/100

Export a site database to a SQL file. Site will be auto-started if not running.

export_siteread onlyauthsource verified80/100

Export a WordPress site to a zip file. Site will be auto-started if not running.

get_local_inforead only

Issues (5)

HIGHtool ↗

Output schemas not documented. Tool descriptions state what is returned (e.g., 'Get detailed information') but do not specify the response structure, field names, or types. LLMs cannot plan downstream tool calls or extract required data without knowing response shape.

list_sitesget_siteget_local_infolist_blueprintsget_site_logslist_services

HIGHtool-annotations ↗

No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications. Tools marked DESTRUCTIVE (delete_site) or WRITE (start_site, wp_cli) lack machine-readable hints. Agents cannot distinguish safe reads from dangerous mutations without parsing descriptions.

delete_sitestart_sitestop_siterestart_sitewp_clicreate_site

MEDIUMconstrained-input ↗

Parameter descriptions lack format constraints and validation rules. E.g., 'site' parameter accepts 'Site name or ID' but does not specify format, length, or character restrictions. 'php_version' accepts '8.2.10' but no pattern or enum of valid versions provided. LLMs cannot validate inputs without explicit constraints.

Recommendations

Add output schema documentation to every tool. For list_sites, document: {sites: [{id: string, name: string, status: 'running'|'stopped', domain: string}], total: number}. For get_site, document all returned fields (PHP version, database type, etc.).
Implement tool annotations in the MCP server. Add readOnlyHint: true to list_*, get_*, export_*, and false to create_*, delete_*, start_*, stop_*, wp_cli. Add destructiveHint: true to delete_site. This enables agents to reason about side effects.
Expand parameter descriptions with format constraints. E.g., 'site: Site name or ID (alphanumeric, 1-255 chars)'. For php_version, provide enum: ['7.4.33', '8.0.30', '8.1.27', '8.2.10', '8.3.0'] or a pattern. For command in wp_cli, document: 'Array of WP-CLI command tokens, e.g., ["plugin", "list", "--format=json"]. First token must be a valid WP-CLI command.'
Add recovery guidance to error scenarios. E.g., get_site description: 'Returns site details. If site not found, call list_sites() to see available sites.' delete_site: 'Permanently deletes a site. Requires confirm=true. If deletion fails, check that the site is not currently running.'
Expand tool descriptions to 100-200 chars with context. E.g., get_local_info: 'Retrieve Local installation metadata including version, platform, and available PHP/MySQL versions. Call this first to understand the environment before creating or modifying sites.' toggle_xdebug: 'Enable or disable Xdebug PHP debugger for a site. Useful for debugging plugin/theme issues. Requires the site to be running.'

Score history

Overall score trend

First recorded score · v2 rubric

60/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	C	60	2026-07-28+	v2