10up

Localwp Agent Tools — AI skill for Claude Code

AI community

A Local add-on that provides an MCP server, skills, and project context for AI-powered WordPress development.

How to install Localwp Agent Tools

This entry records only its repository, not the path inside it, so there is no exact command to give. Open 10up/localwp-agent-tools and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Localwp Agent Tools does

A Local add-on that provides an MCP server, skills, and project context for AI-powered WordPress development. Works with Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP client.

Alternatives in AI

  • Jcodemunch MCP — Cut AI token costs 95%+ on code exploration 2.6k ★
  • Glade MCP — Connect any MCP-compatible AI client (Claude Code, Cursor, Windsurf) to Unity or Godot 201 ★
  • Awareness Local — Local-first AI agent memory — one command, works offline, no account needed 199 ★

README

LocalWP Agent Tools

[![Support Level](https://img.shields.io/badge/support-active-green.svg)](#support-level) [![CI](https://github.com/10up/localwp-agent-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/10up/localwp-agent-tools/actions/workflows/ci.yml) [![GPL-2.0-or-later License](https://img.shields.io/github/license/10up/localwp-agent-tools.svg)](https://github.com/10up/localwp-agent-tools/blob/main/LICENSE.md)

A [Local](https://localwp.com/) add-on that provides an MCP server and project context for AI-powered WordPress development. Works with Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP client.

What It Does

When you click "Enable" on a site in Local, the add-on:

  1. Registers the site with the MCP server — a single HTTP server running in Local's main process that gives AI tools access to WP-CLI, error logs, configuration, and site management
  2. Writes MCP config (.mcp.json, .cursor/mcp.json, etc.) — auto-configured with the correct HTTP endpoint and the per-install bearer token for each agent (see Authentication below)
  3. Generates project context (CLAUDE.md, .cursorrules, etc.) — site context including PHP/MySQL versions, active plugins, theme, and file structure
  4. Updates .gitignore — the MCP config files now carry a secret (the bearer token) alongside the generated context files, so all of them are git-ignored and none are committed

Then open the site folder in your AI tool of choice and you're ready to go.

Architecture

The MCP server runs as a single HTTP server inside Local's Electron main process — no separate Node.js processes per site. It serves two kinds of endpoint:

http://localhost:{port}/sites/mcp             # global — all of Local
http://localhost:{port}/sites/{siteId}/mcp    # one specific site

The server uses the MCP Streamable HTTP transport. The port is stable across restarts (persisted at `~/.local-agent-tools/port`, default 24842).

Sites re