home / mcp / wordpress trac mcp server

WordPress Trac MCP Server

Provides MCP access to WordPress.org Trac issues across Core, Meta, Plugins, Themes, bbPress, BuddyPress, and GlotPress with search, detail, and timeline capabilities.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "courtneyr-dev-meta-trac": {
      "url": "https://mcp-server-wporg-core-trac.meta-trac-wordpress.workers.dev/mcp",
      "headers": {
        "TRAC_BASE_URL": "https://mcp.example.com/mcp",
        "TRAC_INSTANCE": "core"
      }
    }
  }
}

You can search, filter, and view details from WordPress.org Trac issue trackers directly through MCP-enabled AI assistants. This MCP server aggregates multiple Trac instances and exposes search, details, and timeline capabilities, so your AI can quickly surface relevant tickets and changes without leaving your chat.

How to use

Once you have an MCP client connected to these servers, you can perform common actions such as searching for tickets across Trac instances, pulling specific ticket details, viewing changesets, checking timelines, and listing project milestones. Start by telling your AI to search for topics (for example, REST API issues) or to show details for a particular ticket number. The agents will route your query to the appropriate Trac instance and return concise results with references to the live tickets.

If you want to explore a specific Trac instance, ask for a scope like Core Trac, Meta Trac, Plugins Trac, Themes Trac, or any of the other supported instances. You can also request unified results across multiple instances to compare activity, status, or recent changes.

How to install

Prerequisites you need on your machine before starting: a supported Node.js and npm environment, plus access to the MCP client you use (Claude, ChatGPT, or another compatible assistant). The following steps outline how to set up and deploy the MCP server locally or in a development environment.

Clone the MCP server repository, install dependencies, and prepare for deployment.

git clone https://github.com/courtneyr-dev/meta-trac.git
cd meta-trac
npm install

Log in to your Cloudflare account if you plan to deploy using Cloudflare Workers, and deploy the specific Trac instances you need.

npx wrangler login

Deploy the Trac MCP instances you want to run. You can deploy individual Trac servers or all of them at once.

npm run deploy:core       # Core Trac
npm run deploy:meta       # Meta Trac
npm run deploy:plugins    # Plugins Trac
npm run deploy:themes     # Themes Trac
npm run deploy:bbpress    # bbPress Trac
npm run deploy:buddypress # BuddyPress Trac
npm run deploy:glotpress  # GlotPress Trac

# Or deploy ALL at once
npm run deploy:all

Optionally, run the development server locally to test MCP endpoints and verify connectivity, then perform a health check once deployed.

npm run dev
npx @modelcontextprotocol/inspector http://localhost:8787/mcp

Additional content and notes

Environment variables you may use to customize behavior include TRAC_INSTANCE to select which Trac to connect to by default and TRAC_BASE_URL to override the base URL if needed.

Tools exposed by the server let you search, retrieve ticket details, view changesets, check timelines, and list milestones. Use these capabilities through your MCP client to streamline your workflow.

Security and maintenance

Each Trac instance is deployed as a separate MCP deployment, and the server endpoints are designed to be publicly accessible without authentication for read-only CSV/RSS access. Use standard security practices for your deployment environment and monitor for updates or changes to the MCP server components.

Available tools

searchTickets

Search tickets across a Trac instance using a query string and optional filters such as limit and status.

getTicketDetails

Retrieve detailed information for a specific ticket by its number or URL.

showChangeset

Display the changeset or revision details for a given changeset ID.

timeline

Check the activity timeline for a Trac instance within a defined period.

listMilestones

List milestones for a given Trac project or Trac instance.