WordPress Trac MCP server

A read-only Model Context Protocol server for WordPress Core Trac. It runs as a Cloudflare Worker and uses Trac's public HTML, CSV, RSS, and diff endpoints.

Live server:

• Standard MCP: https://mcp-server-wporg-trac-staging.a8cai.workers.dev/mcp

• Search/fetch compatibility: https://mcp-server-wporg-trac-staging.a8cai.workers.dev/mcp/chatgpt

• Health check: https://mcp-server-wporg-trac-staging.a8cai.workers.dev/health

Tools

The standard /mcp endpoint provides:

The /mcp/chatgpt compatibility endpoint provides search and fetch. Use a bare number for a ticket and an r prefix for a changeset: 65739 and r58504.

Search filters

searchTickets accepts plain keywords, ticket numbers, or filter expressions joined with &:

{
  "query": "milestone=6.9&status=closed&resolution=fixed",
  "limit": 50,
  "page": 2
}

It also accepts status, component, milestone, and resolution as separate arguments. A separate argument overrides the same field in query. Results include pagination metadata.

Related MCP server: WordPress MCP

Connect

Remote-capable MCP clients can connect directly to the standard endpoint. Clients that need a local bridge can use mcp-remote:

{
  "mcpServers": {
    "wordpress-trac": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server-wporg-trac-staging.a8cai.workers.dev/mcp"
      ]
    }
  }
}

For ChatGPT, add the compatibility endpoint as a custom app. See OpenAI's current MCP help because product labels and setup steps change.

Develop

Requirements: Node.js 22 or later and pnpm 10.

pnpm install
pnpm dev

Run the complete local quality gate:

pnpm check

This runs TypeScript, Biome, Vitest, and a Cloudflare Worker dry-run build. See docs/testing.md for manual protocol and live-data checks.

Deployment requires a configured Cloudflare account:

pnpm deploy
pnpm deploy:production

Design and safety

• The server is read-only and has no Trac credentials.

• Tool inputs receive runtime validation before any upstream request.

• Upstream requests use the fixed core.trac.wordpress.org host.

• Responses are parsed from public Trac pages and machine-readable formats.

• The Worker keeps no ticket cache or durable state.

Contribute

Keep tool schemas, runtime validation, tests, and documentation aligned. Run pnpm check before opening a pull request.

License

GPL-2.0-or-later.