Skip to content

v1.8.0 - Tool names: dots → underscores (Claude.ai compat)

Choose a tag to compare

@TaherSayed TaherSayed released this 26 May 12:26
· 5 commits to main since this release

Breaking-compatible: tool names changed to satisfy Claude.ai

Claude.ai's remote-MCP UI enforces ^[a-zA-Z0-9_-]{1,64}$ on tool names and was rejecting every tool the plugin advertised:

tools.36.FrontendRemoteMcpToolDefinition.name:
String should match pattern '^[a-zA-Z0-9_-]{1,64}$'

All 24 built-in tools are renamed from dotted (site.info, posts.list, media.upload, …) to underscored (site_info, posts_list, media_upload, …). The new names work in Claude.ai, Claude Desktop, and Claude Code.

Auto-migration on upgrade

Plugin::get_settings() now rewrites any legacy dotted ids in the stored enabled_tools option to underscored equivalents on first load and persists the result — so admins keep their existing tool selection without re-checking boxes after upgrade.

What to do after upgrade

  1. Update the plugin to v1.8.0.
  2. Visit wp-admin → Commander → Settings once to trigger the migration.
  3. In Claude.ai → Settings → Integrations, remove and re-add the connector so the tool list refreshes.

Compatibility note for external callers

If you have scripts that hard-code tools/call with name: "site.info", switch them to site_info. Legacy dotted names are not aliased on the wire — they're gone.

Full tool list (new names)

Read: site_info, site_health, posts_list, posts_get, posts_search, media_list, comments_list, terms_list, settings_get
Write: posts_create, posts_update, posts_delete, media_upload, media_delete, comments_moderate, terms_create
Admin: users_list, users_create, users_update, plugins_list, plugins_toggle, themes_list, themes_activate, settings_update