Add MCP (Model Context Protocol) package

projects/packages/mcp/.gitattributes

@@ -0,0 +1,17 @@
+# Files not needed to be distributed in the package.
+.gitattributes    export-ignore
+.github/          export-ignore
+package.json      export-ignore
+
+# Files to include in the mirror repo, but excluded via gitignore
+# Remember to end all directories with `/**` to properly tag every file.
+# /src/js/example.min.js  production-include
+/vendor/wordpress/abilities-api/**  production-include
+
+# Files to exclude from the mirror repo, but included in the monorepo.
+# Remember to end all directories with `/**` to properly tag every file.
+.gitignore        production-exclude
+changelog/**      production-exclude
+.phpcs.dir.xml    production-exclude
+tests/**          production-exclude
+.phpcsignore      production-exclude

projects/packages/mcp/.gitignore

@@ -0,0 +1,2 @@
+vendor/
+node_modules/

projects/packages/mcp/.phan/config.php

@@ -0,0 +1,13 @@
+<?php
+/**
+ * This configuration will be read and overlaid on top of the
+ * default configuration. Command-line arguments will be applied
+ * after this file is read.
+ *
+ * @package automattic/jetpack-mcp
+ */
+
+// Require base config.
+require __DIR__ . '/../../../../.phan/config.base.php';
+
+return make_phan_config( dirname( __DIR__ ) );

projects/packages/mcp/.phpcs.dir.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0"?>
+<ruleset>
+
+	<rule ref="WordPress.WP.I18n">
+		<properties>
+			<property name="text_domain" type="array">
+				<element value="jetpack-mcp" />
+			</property>
+		</properties>
+	</rule>
+	<rule ref="Jetpack.Functions.I18n">
+		<properties>
+			<property name="text_domain" value="jetpack-mcp" />
+		</properties>
+	</rule>
+
+	<rule ref="WordPress.Utils.I18nTextDomainFixer">
+		<properties>
+			<property name="old_text_domain" type="array" />
+			<property name="new_text_domain" value="jetpack-mcp" />
+		</properties>
+	</rule>
+
+</ruleset>

projects/packages/mcp/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+

projects/packages/mcp/README.md

@@ -0,0 +1,92 @@
+# Jetpack MCP Package
+
+Provides MCP (Model Context Protocol) ability registry and related functionality for Jetpack. This package enables cross-platform MCP support across WPCOM, Atomic, and self-hosted Jetpack sites.
+
+## Features
+
+- **Complete Abilities Registry**: Port of the WordPress.com MCP Abilities Registry
+- **Cross-Platform Support**: Works on WPCOM, Atomic, and self-hosted sites
+- **Memory Efficient**: Configuration-driven architecture with lazy loading
+- **Extensible**: Easy to add new abilities and executors
+- **Integration Ready**: Powers site settings and MCP server functionality
+
+## What's Included
+
+This package contains the complete AbilitiesRegistry system:
+
+- **Registry/AbilityRegistry.php** - Main registry class with lookup methods
+- **abilities-config.php** - Central configuration for all abilities
+- **Abilities/** - Lightweight ability classes (User, Post, Analytics, etc.)
+- **Executors/** - Heavy execution logic classes
+- **Interfaces/** - Contracts for abilities and executors
+- **Traits/** - Shared functionality and user context
+- **Helpers/** - Utility classes for common operations
+- **Factories/** - On-demand executor creation with caching
+
+## Usage
+
+### Getting MCP Abilities
+
+```php
+use Automattic\Jetpack\AbilitiesRegistry\Registry\AbilityRegistry;
+
+// Get all resources for site-level server
+$resources = AbilityRegistry::get_resources_for_server( 'site-level' );
+
+// Get all tools for site-level server  
+$tools = AbilityRegistry::get_tools_for_server( 'site-level' );
+
+// Get all prompts for site-level server
+$prompts = AbilityRegistry::get_prompts_for_server( 'site-level' );
+
+// Get metadata for a specific ability
+$metadata = AbilityRegistry::get_metadata( 'wpcom-mcp/posts-search' );
+```
+
+### Available Abilities
+
+The package includes these ability categories:
+
+- **User Abilities**: Profile, sites, achievements, connections, notifications, security, subscriptions
+- **Post Abilities**: Search, retrieval, and management
+- **Analytics Abilities**: Site statistics and metrics
+- **Example Abilities**: Templates for creating new abilities
+
+### Integration
+
+This package integrates with:
+- **Site Settings API**: Provides MCP abilities to the site settings endpoint
+- **MCP Servers**: Used by MCP servers to determine available abilities
+- **WordPress Admin**: Powers MCP ability configuration in WordPress admin
+
+## Architecture
+
+The Abilities Registry uses a memory-efficient, configuration-driven architecture:
+
+- **Abilities**: Lightweight classes that handle registration and delegate execution
+- **Executors**: Heavy classes containing the actual execution logic (only loaded when needed)
+- **Registry**: Configuration-driven system that eliminates hardcoded ability names
+- **Factory**: Creates executor instances on-demand with caching
+
+## How to install mcp
+
+### Installation From Git Repo
+
+This package is part of the Jetpack monorepo and is automatically available when Jetpack is installed.
+
+## Contribute
+
+## Get Help
+
+## Using this package in your WordPress plugin
+
+If you plan on using this package in your WordPress plugin, we would recommend that you use [Jetpack Autoloader](https://packagist.org/packages/automattic/jetpack-autoloader) as your autoloader. This will allow for maximum interoperability with other plugins that use this package as well.
+
+## Security
+
+Need to report a security vulnerability? Go to [https://automattic.com/security/](https://automattic.com/security/) or directly to our security bug bounty site [https://hackerone.com/automattic](https://hackerone.com/automattic).
+
+## License
+
+mcp is licensed under [GNU General Public License v2 (or later)](./LICENSE.txt)
+

projects/packages/mcp/changelog/initial-version

@@ -0,0 +1,4 @@
+Significance: patch
+Type: added
+
+Initial version.

projects/packages/mcp/composer.json

@@ -0,0 +1,71 @@
+{
+	"name": "automattic/jetpack-mcp",
+	"description": "Adds MCP tools support",
+	"type": "jetpack-library",
+	"license": "GPL-2.0-or-later",
+	"require": {
+		"php": ">=7.4",
+		"wordpress/abilities-api": "^0.1.1"
+	},
+	"config": {
+		"allow-plugins": {
+			"automattic/jetpack-autoloader": true
+		}
+	},
+	"require-dev": {
+		"yoast/phpunit-polyfills": "^4.0.0",
+		"automattic/jetpack-changelogger": "@dev",
+		"automattic/phpunit-select-config": "@dev",
+		"phpunit/phpunit": "^9.6"
+	},
+	"autoload": {
+		"classmap": [
+			"src/"
+		]
+	},
+	"scripts": {
+		"build-development": "echo 'Add your build step to composer.json, please!'",
+		"build-production": "echo 'Add your build step to composer.json, please!'",
+		"phpunit": [
+			"phpunit-select-config phpunit.#.xml.dist --colors=always"
+		],
+		"test-coverage": [
+			"php -dpcov.directory=. ./vendor/bin/phpunit-select-config phpunit.#.xml.dist --coverage-php \"$COVERAGE_DIR/php.cov\""
+		],
+		"test-php": [
+			"@composer phpunit"
+		]
+	},
+	"repositories": [
+		{
+			"type": "vcs",
+			"url": "https://github.com/WordPress/abilities-api"
+		},
+		{
+			"type": "path",
+			"url": "../../packages/*",
+			"options": {
+				"monorepo": true
+			}
+		}
+	],
+	"minimum-stability": "dev",
+	"prefer-stable": true,
+	"extra": {
+		"autotagger": false,
+		"branch-alias": {
+			"dev-trunk": "0.1.x-dev"
+		},
+		"changelogger": {
+			"link-template": "https://github.com/Automattic/jetpack-mcp/compare/v${old}...v${new}"
+		},
+		"mirror-repo": "Automattic/jetpack-mcp",
+		"textdomain": "jetpack-mcp",
+		"version-constants": {
+			"::PACKAGE_VERSION": "src/class-mcp.php"
+		}
+	},
+	"suggest": {
+		"automattic/jetpack-autoloader": "Allow for better interoperability with other plugins that use this package."
+	}
+}

projects/packages/mcp/package.json

@@ -0,0 +1,24 @@
+{
+	"name": "@automattic/jetpack-mcp",
+	"version": "0.1.0-alpha",
+	"private": true,
+	"description": "Adds MCP tools support",
+	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/packages/mcp/#readme",
+	"bugs": {
+		"url": "https://github.com/Automattic/jetpack/labels/[Package] Mcp"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Automattic/jetpack.git",
+		"directory": "projects/packages/mcp"
+	},
+	"license": "GPL-2.0-or-later",
+	"author": "Automattic",
+	"scripts": {
+		"build": "echo 'Not implemented.'",
+		"build-js": "echo 'Not implemented.'",
+		"build-production": "echo 'Not implemented.'",
+		"build-production-js": "echo 'Not implemented.'",
+		"clean": "true"
+	}
+}

projects/packages/mcp/phpunit.11.xml.dist

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+	bootstrap="tests/php/bootstrap.php"
+	cacheDirectory=".phpunit.cache"
+	colors="true"
+	executionOrder="depends"
+	beStrictAboutOutputDuringTests="true"
+	displayDetailsOnPhpunitDeprecations="true"
+	displayDetailsOnTestsThatTriggerDeprecations="true"
+	displayDetailsOnTestsThatTriggerErrors="true"
+	displayDetailsOnTestsThatTriggerNotices="true"
+	displayDetailsOnTestsThatTriggerWarnings="true"
+	failOnDeprecation="true"
+	failOnEmptyTestSuite="true"
+	failOnPhpunitDeprecation="true"
+	failOnNotice="true"
+	failOnRisky="true"
+	failOnWarning="true"
+>
+	<testsuites>
+		<testsuite name="main">
+			<directory suffix="Test.php">tests/php</directory>
+		</testsuite>
+	</testsuites>
+
+	<source>
+		<include>
+			<!-- Better to only include "src" than to add "." and then exclude "tests", "vendor", and so on, as PHPUnit still scans the excluded directories. -->
+			<!-- Add additional lines for any files or directories outside of src/ that need coverage. -->
+			<directory suffix=".php">src</directory>
+		</include>
+	</source>
+	<coverage ignoreDeprecatedCodeUnits="true">
+	</coverage>
+</phpunit>

projects/packages/mcp/phpunit.12.xml.dist

@@ -0,0 +1 @@
+phpunit.11.xml.dist

projects/packages/mcp/phpunit.8.xml.dist

@@ -0,0 +1 @@
+phpunit.9.xml.dist

projects/packages/mcp/phpunit.9.xml.dist

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
+	bootstrap="tests/php/bootstrap.php"
+	cacheResultFile=".phpunit.cache/test-results"
+	colors="true"
+	executionOrder="depends"
+	beStrictAboutOutputDuringTests="true"
+	failOnRisky="true"
+	failOnWarning="true"
+>
+	<testsuites>
+		<testsuite name="main">
+			<directory suffix="Test.php">tests/php</directory>
+		</testsuite>
+	</testsuites>
+</phpunit>