From 44bf7d812f2b6eacdd4fa27ba30b880b0a9f9b71 Mon Sep 17 00:00:00 2001
From: Tim Carr <tim@n7studios.co.uk>
Date: Tue, 8 Sep 2026 10:52:41 +0800
Subject: [PATCH 1/3] MCP: Resources

---
 includes/mcp/class-convertkit-mcp.php         |  36 ++
 .../class-convertkit-mcp-resource-account.php | 110 ++++++
 ...onvertkit-mcp-resource-forms-reference.php | 106 +++++
 .../class-convertkit-mcp-resource-forms.php   |  83 ++++
 ...-convertkit-mcp-resource-landing-pages.php |  83 ++++
 .../class-convertkit-mcp-resource-list.php    | 102 +++++
 ...class-convertkit-mcp-resource-overview.php | 109 ++++++
 ...class-convertkit-mcp-resource-products.php |  83 ++++
 ...lass-convertkit-mcp-resource-reference.php |  66 ++++
 ...cp-resource-restrict-content-reference.php | 101 +++++
 ...ertkit-mcp-resource-settings-reference.php |  99 +++++
 ...class-convertkit-mcp-resource-settings.php | 138 +++++++
 .../class-convertkit-mcp-resource-tags.php    |  83 ++++
 ...sourceTest.php => MCPResourceListTest.php} |   5 +-
 tests/Integration/MCPResourcesTest.php        | 363 ++++++++++++++++++
 wp-convertkit.php                             |  12 +
 16 files changed, 1577 insertions(+), 2 deletions(-)
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-account.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-forms.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-landing-pages.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-list.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-overview.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-products.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-reference.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-settings.php
 create mode 100644 includes/mcp/resources/class-convertkit-mcp-resource-tags.php
 rename tests/Integration/{MCPResourceTest.php => MCPResourceListTest.php} (97%)
 create mode 100644 tests/Integration/MCPResourcesTest.php

diff --git a/includes/mcp/class-convertkit-mcp.php b/includes/mcp/class-convertkit-mcp.php
index 9d0f9ae23..aeaf54c96 100644
--- a/includes/mcp/class-convertkit-mcp.php
+++ b/includes/mcp/class-convertkit-mcp.php
@@ -92,6 +92,9 @@ public function __construct() {
 		// so they're added here rather than via a per-class register_abilities().
 		add_filter( 'convertkit_abilities', array( $this, 'register_resource_abilities' ) );
 
+		// Register MCP resources (live-state lists, account, settings and reference docs).
+		add_filter( 'convertkit_resources', array( $this, 'register_mcp_resources' ) );
+
 		// Register settings get / update abilities for each Plugin settings
 		// These are owned by the Plugin (not by any single feature),
 		// so they're added here rather than via a per-class register_abilities().
@@ -207,6 +210,39 @@ public function register_resource_abilities( $abilities ) {
 
 	}
 
+	/**
+	 * Appends the MCP resources (live-state lists, account, settings and
+	 * reference docs) to the convertkit_resources filter, so they are
+	 * registered with the Abilities API and exposed as MCP Resources.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $resources   Resources to register.
+	 * @return  array
+	 */
+	public function register_mcp_resources( $resources ) {
+
+		$mcp_resources = array(
+			new ConvertKit_MCP_Resource_Forms(),
+			new ConvertKit_MCP_Resource_Tags(),
+			new ConvertKit_MCP_Resource_Landing_Pages(),
+			new ConvertKit_MCP_Resource_Products(),
+			new ConvertKit_MCP_Resource_Account(),
+			new ConvertKit_MCP_Resource_Settings(),
+			new ConvertKit_MCP_Resource_Overview(),
+			new ConvertKit_MCP_Resource_Forms_Reference(),
+			new ConvertKit_MCP_Resource_Restrict_Content_Reference(),
+			new ConvertKit_MCP_Resource_Settings_Reference(),
+		);
+
+		foreach ( $mcp_resources as $resource ) {
+			$resources[ $resource->get_name() ] = $resource;
+		}
+
+		return $resources;
+
+	}
+
 	/**
 	 * Register the 'kit' ability category.
 	 *
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-account.php b/includes/mcp/resources/class-convertkit-mcp-resource-account.php
new file mode 100644
index 000000000..d94764bc7
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-account.php
@@ -0,0 +1,110 @@
+<?php
+/**
+ * Kit MCP Resource: Account.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the connected Kit account (name, plan, primary email) as an MCP
+ * Resource (`kit://account`), read from the cached account data.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Account extends ConvertKit_MCP_Resource {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/account';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://account';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Account', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The connected Kit account (name, plan type, primary email address), as JSON. Read this to confirm which account the site is connected to before making changes. An empty object means no account is connected yet.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource content's MIME type.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_mime_type() {
+
+		return 'application/json';
+
+	}
+
+	/**
+	 * Executes the resource: return the cached account data as JSON.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input (unused).
+	 * @return  string|WP_Error
+	 */
+	public function execute_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		// Bail with an empty object if the account resource class isn't available.
+		if ( ! class_exists( 'ConvertKit_Resource_Account' ) ) {
+			return '{}';
+		}
+
+		$account = new ConvertKit_Resource_Account();
+		$data    = $account->get();
+
+		// get() returns false when nothing is cached; normalise to an empty object.
+		if ( ! is_array( $data ) ) {
+			return '{}';
+		}
+
+		return (string) wp_json_encode( $data );
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php b/includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php
new file mode 100644
index 000000000..c784df1d4
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php
@@ -0,0 +1,106 @@
+<?php
+/**
+ * Kit MCP Resource: Forms reference.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * A Markdown reference on how Kit Forms embed and display in WordPress
+ * (`kit://reference/forms`).
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Forms_Reference extends ConvertKit_MCP_Resource_Reference {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/reference-forms';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://reference/forms';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Forms Reference', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'How Kit Forms embed and display in WordPress: formats, where they appear, and how a default Form is overridden per post or category.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the Markdown content lines.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_content_lines() {
+
+		return array(
+			'# ' . __( 'Kit Forms in WordPress', 'convertkit' ),
+			'',
+			'## ' . __( 'Formats', 'convertkit' ),
+			'',
+			'- ' . __( '**Inline** forms render in the post content, where the Form is placed or auto-appended.', 'convertkit' ),
+			'- ' . __( '**Modal**, **slide in** and **sticky bar** forms are non-inline: Kit triggers them on the page, so their placement in content does not matter.', 'convertkit' ),
+			'',
+			__( 'The `kit://forms` resource and `kit/forms-list` tool return each Form\'s `format`, so you can tell inline from non-inline Forms.', 'convertkit' ),
+			'',
+			'## ' . __( 'How a Form is chosen for a post', 'convertkit' ),
+			'',
+			__( 'The Form shown on a given post is resolved in this order:', 'convertkit' ),
+			'',
+			'1. ' . __( 'The post\'s own Form setting (`kit/post-settings-update`), if set.', 'convertkit' ),
+			'2. ' . __( 'The Form set on one of the post\'s categories (`kit/category-settings-update`), if set.', 'convertkit' ),
+			'3. ' . __( 'The default Form for the post type, from General settings.', 'convertkit' ),
+			'',
+			__( 'A post can also be set to "None" to show no Form, overriding the defaults.', 'convertkit' ),
+			'',
+			'## ' . __( 'Placing a Form manually', 'convertkit' ),
+			'',
+			__( 'A specific Form can be inserted into content with the Kit Form block or the `[convertkit]` shortcode, rather than relying on the default. Use `kit/forms` to look up the Form ID first.', 'convertkit' ),
+		);
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-forms.php b/includes/mcp/resources/class-convertkit-mcp-resource-forms.php
new file mode 100644
index 000000000..09295e954
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-forms.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Resource: Forms.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the Kit Forms on the connected account as an MCP Resource
+ * (`kit://forms`), mirroring the `kit/forms-list` tool.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Forms extends ConvertKit_MCP_Resource_List {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/forms';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://forms';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Forms', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The Kit Forms on the connected account, as JSON (id, name, format). Read this to map a Form name to its numeric ID before configuring form settings.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the backing ability class.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_ability_class() {
+
+		return 'ConvertKit_MCP_Ability_Resource_Forms';
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-landing-pages.php b/includes/mcp/resources/class-convertkit-mcp-resource-landing-pages.php
new file mode 100644
index 000000000..f109e4966
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-landing-pages.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Resource: Landing Pages.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the Kit Landing Pages on the connected account as an MCP Resource
+ * (`kit://landing-pages`), mirroring the `kit/landing-pages-list` tool.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Landing_Pages extends ConvertKit_MCP_Resource_List {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/landing-pages';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://landing-pages';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Landing Pages', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The Kit Landing Pages on the connected account, as JSON (id, name). Read this to map a Landing Page name to its numeric ID before configuring settings.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the backing ability class.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_ability_class() {
+
+		return 'ConvertKit_MCP_Ability_Resource_Landing_Pages';
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-list.php b/includes/mcp/resources/class-convertkit-mcp-resource-list.php
new file mode 100644
index 000000000..12e74728c
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-list.php
@@ -0,0 +1,102 @@
+<?php
+/**
+ * Kit MCP Resource: list base class.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Base class for live-state resources that expose an existing resource-list
+ * ability's data (Forms, Tags, Landing Pages, Products) as an MCP Resource,
+ * so clients can attach the current id/name mappings as read-only context.
+ *
+ * The data is single-sourced from the equivalent `kit/*-list` tool, so the
+ * resource and tool never drift apart.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+abstract class ConvertKit_MCP_Resource_List extends ConvertKit_MCP_Resource {
+
+	/**
+	 * Returns the class name of the ConvertKit_MCP_Ability_Resource_*
+	 * ability backing this resource.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	abstract protected function get_ability_class();
+
+	/**
+	 * Returns the resource content's MIME type.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_mime_type() {
+
+		return 'application/json';
+
+	}
+
+	/**
+	 * Permission callback.
+	 *
+	 * Matches the backing list tool's `edit_posts` gate, so the same users who
+	 * can look up a Form / Tag when placing a Kit element can read this resource.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input (unused).
+	 * @return  bool|WP_Error
+	 */
+	public function permission_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		if ( ! current_user_can( 'edit_posts' ) ) {
+			return new WP_Error(
+				'convertkit_mcp_resource_permission_callback',
+				__( 'You do not have permission to list Kit resources.', 'convertkit' )
+			);
+		}
+
+		return true;
+
+	}
+
+	/**
+	 * Executes the resource: run the backing list ability and return its result
+	 * as a JSON string.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input.
+	 * @return  string|WP_Error
+	 */
+	public function execute_callback( $input ) {
+
+		$ability_class = $this->get_ability_class();
+		if ( ! class_exists( $ability_class ) ) {
+			return new WP_Error(
+				'convertkit_mcp_resource_ability_missing',
+				sprintf(
+					/* translators: %s: Ability class name */
+					__( 'The ability class "%s" does not exist.', 'convertkit' ),
+					$ability_class
+				)
+			);
+		}
+
+		$ability = new $ability_class();
+		$result  = $ability->execute_callback( $input );
+		if ( is_wp_error( $result ) ) {
+			return $result;
+		}
+
+		return (string) wp_json_encode( $result );
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-overview.php b/includes/mcp/resources/class-convertkit-mcp-resource-overview.php
new file mode 100644
index 000000000..959078bf6
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-overview.php
@@ -0,0 +1,109 @@
+<?php
+/**
+ * Kit MCP Resource: Overview.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * A Markdown overview of what the Kit Plugin does and how its MCP surface fits
+ * together (`kit://overview`).
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Overview extends ConvertKit_MCP_Resource_Reference {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/overview';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://overview';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Plugin Overview', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'What the Kit WordPress Plugin does and how its MCP tools and resources fit together. Read this first to understand the available concepts.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the Markdown content lines.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_content_lines() {
+
+		return array(
+			'# ' . __( 'Kit WordPress Plugin', 'convertkit' ),
+			'',
+			__( 'The Kit Plugin connects a WordPress site to a Kit (formerly ConvertKit) account, letting the site display Kit Forms and Landing Pages, restrict content to subscribers, and import Kit Broadcasts as posts.', 'convertkit' ),
+			'',
+			'## ' . __( 'Core concepts', 'convertkit' ),
+			'',
+			'- ' . __( '**Forms** capture subscribers. They display inline in content, or as a modal / slide in / sticky bar. A default Form can be set per post type, and overridden per post or per category.', 'convertkit' ),
+			'- ' . __( '**Landing Pages** are standalone Kit-hosted pages a WordPress page can be set to display.', 'convertkit' ),
+			'- ' . __( '**Tags** label subscribers; a post can tag a visitor who is a subscriber.', 'convertkit' ),
+			'- ' . __( '**Products** are paid offers used to restrict content to paying subscribers.', 'convertkit' ),
+			'- ' . __( '**Restrict Content** gates a post or page behind a Product, Tag or Form.', 'convertkit' ),
+			'- ' . __( '**Broadcasts** are Kit emails that can be imported into WordPress as posts.', 'convertkit' ),
+			'',
+			'## ' . __( 'Where settings live', 'convertkit' ),
+			'',
+			'- ' . __( '**General** settings control the connection and default Forms per post type.', 'convertkit' ),
+			'- ' . __( '**Per-post** settings (`kit/post-settings-*`) set the Form, Landing Page, Tag or Restrict Content rule for a single post or page.', 'convertkit' ),
+			'- ' . __( '**Per-category** settings (`kit/category-settings-*`) set a Form for a WordPress category.', 'convertkit' ),
+			'',
+			'## ' . __( 'MCP resources to read for context', 'convertkit' ),
+			'',
+			'- `kit://forms`, `kit://tags`, `kit://landing-pages`, `kit://products` — ' . __( 'current id/name mappings on the connected account. Read these to resolve a name to its numeric ID before configuring settings.', 'convertkit' ),
+			'- `kit://account` — ' . __( 'the connected account.', 'convertkit' ),
+			'- `kit://settings` — ' . __( 'the current Plugin settings.', 'convertkit' ),
+			'- `kit://reference/forms`, `kit://reference/restrict-content`, `kit://reference/settings` — ' . __( 'how those features work.', 'convertkit' ),
+		);
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-products.php b/includes/mcp/resources/class-convertkit-mcp-resource-products.php
new file mode 100644
index 000000000..116ab6eea
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-products.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Resource: Products.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the Kit Products on the connected account as an MCP Resource
+ * (`kit://products`), mirroring the `kit/products-list` tool.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Products extends ConvertKit_MCP_Resource_List {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/products';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://products';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Products', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The Kit Products on the connected account, as JSON (id, name). Read this to map a Product name to its numeric ID before configuring restrict content settings.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the backing ability class.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_ability_class() {
+
+		return 'ConvertKit_MCP_Ability_Resource_Products';
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-reference.php b/includes/mcp/resources/class-convertkit-mcp-resource-reference.php
new file mode 100644
index 000000000..15c76ce24
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-reference.php
@@ -0,0 +1,66 @@
+<?php
+/**
+ * Kit MCP Resource: reference base class.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Base class for static reference resources: Markdown documents that describe
+ * how the Plugin works (its mental model), so the model can read them as
+ * context instead of guessing.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+abstract class ConvertKit_MCP_Resource_Reference extends ConvertKit_MCP_Resource {
+
+	/**
+	 * Returns the Markdown content lines for this reference document.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	abstract protected function get_content_lines();
+
+	/**
+	 * Permission callback.
+	 *
+	 * Reference docs are non-sensitive and readable by anyone who can edit
+	 * posts — the audience that uses the MCP tools.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input (unused).
+	 * @return  bool|WP_Error
+	 */
+	public function permission_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		if ( ! current_user_can( 'edit_posts' ) ) {
+			return new WP_Error(
+				'convertkit_mcp_resource_permission_callback',
+				__( 'You do not have permission for this operation.', 'convertkit' )
+			);
+		}
+
+		return true;
+
+	}
+
+	/**
+	 * Executes the resource: return the Markdown document.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input (unused).
+	 * @return  string|WP_Error
+	 */
+	public function execute_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		return implode( "\n", $this->get_content_lines() );
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php b/includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php
new file mode 100644
index 000000000..f98508798
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php
@@ -0,0 +1,101 @@
+<?php
+/**
+ * Kit MCP Resource: Restrict Content reference.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * A Markdown reference on how Restrict Content gates posts and pages
+ * (`kit://reference/restrict-content`).
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Restrict_Content_Reference extends ConvertKit_MCP_Resource_Reference {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/reference-restrict-content';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://reference/restrict-content';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Restrict Content Reference', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'How Restrict Content gates a post or page behind a Kit Product, Tag or Form, and what the visitor sees.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the Markdown content lines.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_content_lines() {
+
+		return array(
+			'# ' . __( 'Restrict Content', 'convertkit' ),
+			'',
+			__( 'Restrict Content gates a single post or page so only qualifying visitors see the full content. Everyone else sees a teaser plus a prompt to subscribe or unlock.', 'convertkit' ),
+			'',
+			'## ' . __( 'What content can be gated by', 'convertkit' ),
+			'',
+			'- ' . __( '**Product** — the visitor must have purchased the Kit Product to view the content (a paywall). Look up the Product ID via `kit://products`.', 'convertkit' ),
+			'- ' . __( '**Tag** — the visitor must be a subscriber with the given Tag. Look up the Tag ID via `kit://tags`.', 'convertkit' ),
+			'- ' . __( '**Form** — the visitor must subscribe via the given Form to unlock. Look up the Form ID via `kit://forms`.', 'convertkit' ),
+			'',
+			'## ' . __( 'How to set it', 'convertkit' ),
+			'',
+			__( 'Set Restrict Content on a post or page with `kit/post-settings-update`, supplying the Product, Tag or Form to gate by. Site-wide behaviour (teaser length, wording, login) is configured in the Restrict Content settings group — read the current values from `kit://settings`.', 'convertkit' ),
+			'',
+			'## ' . __( 'Visitor experience', 'convertkit' ),
+			'',
+			__( 'A returning subscriber can authenticate by email to access Tag- or Form-gated content. Product-gated content requires a completed purchase. Restrict Content applies only to the post types that support it.', 'convertkit' ),
+		);
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php b/includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php
new file mode 100644
index 000000000..9a71c05ea
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php
@@ -0,0 +1,99 @@
+<?php
+/**
+ * Kit MCP Resource: Settings reference.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * A Markdown reference describing what each Plugin settings group controls
+ * (`kit://reference/settings`).
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Settings_Reference extends ConvertKit_MCP_Resource_Reference {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/reference-settings';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://reference/settings';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Settings Reference', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'What each Kit Plugin settings group controls. For current values and exact keys, read kit://settings or the kit/settings-*-get tools.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the Markdown content lines.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_content_lines() {
+
+		return array(
+			'# ' . __( 'Kit Plugin Settings', 'convertkit' ),
+			'',
+			__( 'The Plugin has three settings groups exposed over MCP. Read live values from `kit://settings`, or a single group\'s exact schema and values via its `kit/settings-<group>-get` tool; change values with `kit/settings-<group>-update`.', 'convertkit' ),
+			'',
+			'## ' . __( 'general', 'convertkit' ),
+			'',
+			__( 'The Kit account connection and site-wide defaults: the default Form displayed for each post type, and how non-inline Forms load. This is where most Form defaults are set.', 'convertkit' ),
+			'',
+			'## ' . __( 'broadcasts', 'convertkit' ),
+			'',
+			__( 'Importing Kit Broadcasts into WordPress as posts: whether importing is enabled, and the author, category and status applied to imported posts.', 'convertkit' ),
+			'',
+			'## ' . __( 'restrict-content', 'convertkit' ),
+			'',
+			__( 'Site-wide Restrict Content behaviour: the teaser shown to non-qualifying visitors, the calls to action, and how subscribers authenticate. Per-post gating is set with `kit/post-settings-update` — see `kit://reference/restrict-content`.', 'convertkit' ),
+		);
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-settings.php b/includes/mcp/resources/class-convertkit-mcp-resource-settings.php
new file mode 100644
index 000000000..a2263b335
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-settings.php
@@ -0,0 +1,138 @@
+<?php
+/**
+ * Kit MCP Resource: Settings.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the current Plugin settings (general, broadcasts, restrict content)
+ * as an MCP Resource (`kit://settings`), keyed by settings group.
+ *
+ * Values are single-sourced from the `kit/settings-*-get` tools, so secret
+ * keys are excluded and the resource never drifts from the tools.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Settings extends ConvertKit_MCP_Resource {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/settings';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://settings';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Settings', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The current Kit Plugin settings, as JSON keyed by group (general, broadcasts, restrict-content). Secret keys are excluded. Read this to see the current configuration before updating settings.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource content's MIME type.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_mime_type() {
+
+		return 'application/json';
+
+	}
+
+	/**
+	 * Permission callback.
+	 *
+	 * Settings are restricted to users who can manage options, matching the
+	 * settings tools and the Plugin's own settings screens.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input (unused).
+	 * @return  bool|WP_Error
+	 */
+	public function permission_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		if ( ! current_user_can( 'manage_options' ) ) {
+			return new WP_Error(
+				'convertkit_mcp_resource_permission_callback',
+				__( 'You do not have permission to read Kit Plugin settings.', 'convertkit' )
+			);
+		}
+
+		return true;
+
+	}
+
+	/**
+	 * Executes the resource: return each settings group's current values as JSON.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Resource input.
+	 * @return  string|WP_Error
+	 */
+	public function execute_callback( $input ) {
+
+		// Settings groups exposed over MCP, matching the registered settings tools.
+		$groups = array(
+			new ConvertKit_Settings(),
+			new ConvertKit_Settings_Broadcasts(),
+			new ConvertKit_Settings_Restrict_Content(),
+		);
+
+		$result = array();
+		foreach ( $groups as $settings ) {
+			$get                             = new ConvertKit_MCP_Ability_Settings_Get( $settings );
+			$values                          = $get->execute_callback( $input );
+			$result[ $settings->get_name() ] = is_wp_error( $values ) ? array() : $values;
+		}
+
+		return (string) wp_json_encode( $result );
+
+	}
+
+}
diff --git a/includes/mcp/resources/class-convertkit-mcp-resource-tags.php b/includes/mcp/resources/class-convertkit-mcp-resource-tags.php
new file mode 100644
index 000000000..33ab722ab
--- /dev/null
+++ b/includes/mcp/resources/class-convertkit-mcp-resource-tags.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Resource: Tags.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Exposes the Kit Tags on the connected account as an MCP Resource
+ * (`kit://tags`), mirroring the `kit/tags-list` tool.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Resource_Tags extends ConvertKit_MCP_Resource_List {
+
+	/**
+	 * Returns the resource name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_name() {
+
+		return 'kit/tags';
+
+	}
+
+	/**
+	 * Returns the resource URI.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_uri() {
+
+		return 'kit://tags';
+
+	}
+
+	/**
+	 * Returns the resource label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Kit Tags', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the resource description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'The Kit Tags on the connected account, as JSON (id, name). Read this to map a Tag name to its numeric ID before configuring form or restrict content settings.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the backing ability class.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_ability_class() {
+
+		return 'ConvertKit_MCP_Ability_Resource_Tags';
+
+	}
+
+}
diff --git a/tests/Integration/MCPResourceTest.php b/tests/Integration/MCPResourceListTest.php
similarity index 97%
rename from tests/Integration/MCPResourceTest.php
rename to tests/Integration/MCPResourceListTest.php
index e90cf8fd0..9df3f79f7 100644
--- a/tests/Integration/MCPResourceTest.php
+++ b/tests/Integration/MCPResourceListTest.php
@@ -5,7 +5,8 @@
 use lucatume\WPBrowser\TestCase\WPTestCase;
 
 /**
- * Tests for the Kit MCP resource-list abilities:
+ * Tests for the Kit MCP resource-list abilities (tools), exposed as the
+ * kit/*-list tools. The MCP Resource primitives are covered by MCPResourcesTest.
  *
  * - kit/forms-list          (ConvertKit_MCP_Ability_Resource_Forms)
  * - kit/tags-list           (ConvertKit_MCP_Ability_Resource_Tags)
@@ -14,7 +15,7 @@
  *
  * @since   3.4.0
  */
-class MCPResourceTest extends WPTestCase
+class MCPResourceListTest extends WPTestCase
 {
 	/**
 	 * The testing implementation.
diff --git a/tests/Integration/MCPResourcesTest.php b/tests/Integration/MCPResourcesTest.php
new file mode 100644
index 000000000..e26261813
--- /dev/null
+++ b/tests/Integration/MCPResourcesTest.php
@@ -0,0 +1,363 @@
+<?php
+
+namespace Tests;
+
+use lucatume\WPBrowser\TestCase\WPTestCase;
+
+/**
+ * Tests for the Kit MCP Resource primitive classes, registered via the
+ * `convertkit_resources` filter and exposed by the MCP server as Resources:
+ *
+ * Live-state (JSON):
+ * - kit/forms, kit/tags, kit/landing-pages, kit/products
+ * - kit/account
+ * - kit/settings
+ *
+ * Reference (Markdown):
+ * - kit/overview
+ * - kit/reference-forms
+ * - kit/reference-restrict-content
+ * - kit/reference-settings
+ *
+ * @since   3.5.0
+ */
+class MCPResourcesTest extends WPTestCase
+{
+	/**
+	 * The testing implementation.
+	 *
+	 * @var \WpunitTester.
+	 */
+	protected $tester;
+
+	/**
+	 * Holds the ConvertKit Settings class, so we can seed credentials in
+	 * setUp() and clean up in tearDown().
+	 *
+	 * @since   3.5.0
+	 *
+	 * @var     \ConvertKit_Settings
+	 */
+	private $settings;
+
+	/**
+	 * Live-state list resources: resource name => backing ConvertKit_Resource_*
+	 * class, used to seed / clear the resource cache.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @var     array<string, class-string>
+	 */
+	private const LIST_RESOURCES = array(
+		'kit/forms'         => \ConvertKit_Resource_Forms::class,
+		'kit/tags'          => \ConvertKit_Resource_Tags::class,
+		'kit/landing-pages' => \ConvertKit_Resource_Landing_Pages::class,
+		'kit/products'      => \ConvertKit_Resource_Products::class,
+	);
+
+	/**
+	 * Reference (Markdown) resource names.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @var     string[]
+	 */
+	private const REFERENCE_RESOURCES = array(
+		'kit/overview',
+		'kit/reference-forms',
+		'kit/reference-restrict-content',
+		'kit/reference-settings',
+	);
+
+	/**
+	 * Performs actions before each test.
+	 *
+	 * @since   3.5.0
+	 */
+	public function setUp(): void
+	{
+		parent::setUp();
+
+		// Activate Plugin.
+		activate_plugins('convertkit/wp-convertkit.php');
+
+		// Store credentials, so the live-state resources can fetch data from
+		// the Kit API when init() is called.
+		$this->settings = new \ConvertKit_Settings();
+		update_option(
+			$this->settings::SETTINGS_NAME,
+			[
+				'access_token'  => $_ENV['CONVERTKIT_OAUTH_ACCESS_TOKEN'],
+				'refresh_token' => $_ENV['CONVERTKIT_OAUTH_REFRESH_TOKEN'],
+			]
+		);
+	}
+
+	/**
+	 * Performs actions after each test.
+	 *
+	 * @since   3.5.0
+	 */
+	public function tearDown(): void
+	{
+		// Delete credentials and any cached resources so each test starts clean.
+		delete_option($this->settings::SETTINGS_NAME);
+
+		foreach ( self::LIST_RESOURCES as $resource_class ) {
+			$resource = new $resource_class();
+			delete_option($resource->settings_name);
+			delete_option($resource->settings_name . '_last_queried');
+		}
+
+		$account = new \ConvertKit_Resource_Account();
+		delete_option($account->settings_name);
+		delete_option($account->settings_name . '_last_queried');
+
+		// Restore the current user.
+		wp_set_current_user(0);
+
+		// Deactivate Plugin.
+		deactivate_plugins('convertkit/wp-convertkit.php');
+
+		parent::tearDown();
+	}
+
+	/**
+	 * Test that all resources are registered with the `convertkit_resources`
+	 * filter, so they are picked up by the Abilities API and exposed by the
+	 * MCP server.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testResourcesRegistered()
+	{
+		$resources = convertkit_get_resources();
+
+		$expected = array(
+			'kit/forms'                      => \ConvertKit_MCP_Resource_Forms::class,
+			'kit/tags'                       => \ConvertKit_MCP_Resource_Tags::class,
+			'kit/landing-pages'              => \ConvertKit_MCP_Resource_Landing_Pages::class,
+			'kit/products'                   => \ConvertKit_MCP_Resource_Products::class,
+			'kit/account'                    => \ConvertKit_MCP_Resource_Account::class,
+			'kit/settings'                   => \ConvertKit_MCP_Resource_Settings::class,
+			'kit/overview'                   => \ConvertKit_MCP_Resource_Overview::class,
+			'kit/reference-forms'            => \ConvertKit_MCP_Resource_Forms_Reference::class,
+			'kit/reference-restrict-content' => \ConvertKit_MCP_Resource_Restrict_Content_Reference::class,
+			'kit/reference-settings'         => \ConvertKit_MCP_Resource_Settings_Reference::class,
+		);
+
+		foreach ( $expected as $name => $class ) {
+			$this->assertArrayHasKey($name, $resources);
+			$this->assertInstanceOf($class, $resources[ $name ]);
+		}
+	}
+
+	/**
+	 * Test that every registered resource advertises a kit:// URI and a
+	 * supported MIME type.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testResourcesHaveUriAndMimeType()
+	{
+		$resources = convertkit_get_resources();
+
+		foreach ( $resources as $name => $resource ) {
+			$this->assertStringStartsWith('kit://', $resource->get_uri());
+			$this->assertContains(
+				$resource->get_mime_type(),
+				[ 'application/json', 'text/markdown' ]
+			);
+		}
+	}
+
+	/**
+	 * Test that live-state and reference resources deny access to a user
+	 * without the edit_posts capability.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testEditPostsResourcesDenyWithoutEditPostsCapability()
+	{
+		// Become a Subscriber (no edit_posts capability).
+		$subscriber_id = static::factory()->user->create([ 'role' => 'subscriber' ]);
+		wp_set_current_user($subscriber_id);
+
+		$resources = convertkit_get_resources();
+
+		$names = array_merge(
+			array_keys( self::LIST_RESOURCES ),
+			self::REFERENCE_RESOURCES
+		);
+
+		foreach ( $names as $name ) {
+			$this->assertInstanceOf(\WP_Error::class, $resources[ $name ]->permission_callback([]));
+		}
+	}
+
+	/**
+	 * Test that an Editor can read the live-state list and reference resources.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testEditPostsResourcesPermitWithEditPostsCapability()
+	{
+		// Become an Editor (has edit_posts capability).
+		$editor_id = static::factory()->user->create([ 'role' => 'editor' ]);
+		wp_set_current_user($editor_id);
+
+		$resources = convertkit_get_resources();
+
+		$names = array_merge(
+			array_keys( self::LIST_RESOURCES ),
+			self::REFERENCE_RESOURCES
+		);
+
+		foreach ( $names as $name ) {
+			$this->assertTrue($resources[ $name ]->permission_callback([]));
+		}
+	}
+
+	/**
+	 * Test that the account and settings resources require the manage_options
+	 * capability: denied for an Editor, permitted for an Administrator.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testManageOptionsResourcesEnforceCapability()
+	{
+		$resources = convertkit_get_resources();
+
+		// Editor is denied.
+		$editor_id = static::factory()->user->create([ 'role' => 'editor' ]);
+		wp_set_current_user($editor_id);
+		$this->assertInstanceOf(\WP_Error::class, $resources['kit/account']->permission_callback([]));
+		$this->assertInstanceOf(\WP_Error::class, $resources['kit/settings']->permission_callback([]));
+
+		// Administrator is permitted.
+		$admin_id = static::factory()->user->create([ 'role' => 'administrator' ]);
+		wp_set_current_user($admin_id);
+		$this->assertTrue($resources['kit/account']->permission_callback([]));
+		$this->assertTrue($resources['kit/settings']->permission_callback([]));
+	}
+
+	/**
+	 * Test that list resources return a valid JSON { count, items } string
+	 * with count 0 when nothing is cached.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testListResourcesReturnEmptyJsonWhenNoCache()
+	{
+		$resources = convertkit_get_resources();
+
+		foreach ( self::LIST_RESOURCES as $name => $resource_class ) {
+			// Ensure the cache is empty for this resource.
+			delete_option( ( new $resource_class() )->settings_name );
+
+			$json = $resources[ $name ]->execute_callback([]);
+			$this->assertIsString($json);
+
+			$data = json_decode($json, true);
+			$this->assertIsArray($data);
+			$this->assertArrayHasKey('count', $data);
+			$this->assertArrayHasKey('items', $data);
+			$this->assertSame(0, $data['count']);
+			$this->assertSame([], $data['items']);
+		}
+	}
+
+	/**
+	 * Test that each list resource returns exactly its backing list tool's
+	 * output, JSON encoded. This proves the resource is single-sourced from
+	 * the tool, independent of how many items the connected account holds.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testListResourcesMatchBackingTool()
+	{
+		$resources = convertkit_get_resources();
+
+		// Each list resource wraps the equivalent resource-list ability.
+		$abilities = array(
+			'kit/forms'         => \ConvertKit_MCP_Ability_Resource_Forms::class,
+			'kit/tags'          => \ConvertKit_MCP_Ability_Resource_Tags::class,
+			'kit/landing-pages' => \ConvertKit_MCP_Ability_Resource_Landing_Pages::class,
+			'kit/products'      => \ConvertKit_MCP_Ability_Resource_Products::class,
+		);
+
+		foreach ( self::LIST_RESOURCES as $name => $resource_class ) {
+			// Populate the resource cache from the Kit API.
+			( new $resource_class() )->init();
+
+			// The backing tool's output shape.
+			$expected = ( new $abilities[ $name ]() )->execute_callback([]);
+			$this->assertIsArray($expected);
+			$this->assertArrayHasKey('count', $expected);
+			$this->assertArrayHasKey('items', $expected);
+
+			// The resource must return exactly that, JSON encoded.
+			$this->assertSame( (string) wp_json_encode($expected), $resources[ $name ]->execute_callback([]));
+		}
+	}
+
+	/**
+	 * Test that the account resource returns an empty JSON object when no
+	 * account is cached, and exactly the cached account data as JSON once
+	 * populated (whatever shape the account API returns).
+	 *
+	 * @since   3.5.0
+	 */
+	public function testAccountResource()
+	{
+		$resources = convertkit_get_resources();
+		$account   = new \ConvertKit_Resource_Account();
+
+		// Empty cache returns an empty object.
+		delete_option($account->settings_name);
+		$this->assertSame('{}', $resources['kit/account']->execute_callback([]));
+
+		// Populated cache returns exactly the cached account data, JSON encoded.
+		$account->init();
+		$stored   = $account->get();
+		$expected = is_array($stored) ? (string) wp_json_encode($stored) : '{}';
+		$this->assertSame($expected, $resources['kit/account']->execute_callback([]));
+	}
+
+	/**
+	 * Test that the settings resource returns a JSON object keyed by settings
+	 * group.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testSettingsResource()
+	{
+		$resources = convertkit_get_resources();
+
+		$data = json_decode($resources['kit/settings']->execute_callback([]), true);
+		$this->assertIsArray($data);
+		$this->assertArrayHasKey('general', $data);
+		$this->assertArrayHasKey('broadcasts', $data);
+		$this->assertArrayHasKey('restrict-content', $data);
+	}
+
+	/**
+	 * Test that reference resources return non-empty Markdown beginning with a
+	 * heading.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testReferenceResourcesReturnMarkdown()
+	{
+		$resources = convertkit_get_resources();
+
+		foreach ( self::REFERENCE_RESOURCES as $name ) {
+			$this->assertSame('text/markdown', $resources[ $name ]->get_mime_type());
+
+			$content = $resources[ $name ]->execute_callback([]);
+			$this->assertIsString($content);
+			$this->assertNotEmpty($content);
+			$this->assertStringStartsWith('#', $content);
+		}
+	}
+}
diff --git a/wp-convertkit.php b/wp-convertkit.php
index ac23fcc03..067821936 100644
--- a/wp-convertkit.php
+++ b/wp-convertkit.php
@@ -110,6 +110,18 @@
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/class-convertkit-mcp-ability.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/class-convertkit-mcp-resource.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/class-convertkit-mcp-prompt.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-list.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-reference.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-forms.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-tags.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-landing-pages.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-products.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-account.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-settings.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-overview.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/class-convertkit-mcp.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/abilities/content/class-convertkit-mcp-ability-content.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/abilities/content/class-convertkit-mcp-ability-content-list.php';

From 965a80d785d2c9fbd304ff7d1cb414db5cccb91c Mon Sep 17 00:00:00 2001
From: Tim Carr <tim@n7studios.co.uk>
Date: Tue, 8 Sep 2026 11:11:05 +0800
Subject: [PATCH 2/3] MCP: Prompts

---
 includes/mcp/class-convertkit-mcp.php         |  31 +++
 .../class-convertkit-mcp-prompt-add-form.php  | 122 +++++++++++
 .../class-convertkit-mcp-prompt-audit.php     |  87 ++++++++
 ...mcp-prompt-configure-broadcasts-import.php |  83 ++++++++
 ...convertkit-mcp-prompt-restrict-content.php | 118 +++++++++++
 .../class-convertkit-mcp-prompt-setup.php     |  83 ++++++++
 tests/Integration/MCPPromptsTest.php          | 193 ++++++++++++++++++
 wp-convertkit.php                             |   5 +
 8 files changed, 722 insertions(+)
 create mode 100644 includes/mcp/prompts/class-convertkit-mcp-prompt-add-form.php
 create mode 100644 includes/mcp/prompts/class-convertkit-mcp-prompt-audit.php
 create mode 100644 includes/mcp/prompts/class-convertkit-mcp-prompt-configure-broadcasts-import.php
 create mode 100644 includes/mcp/prompts/class-convertkit-mcp-prompt-restrict-content.php
 create mode 100644 includes/mcp/prompts/class-convertkit-mcp-prompt-setup.php
 create mode 100644 tests/Integration/MCPPromptsTest.php

diff --git a/includes/mcp/class-convertkit-mcp.php b/includes/mcp/class-convertkit-mcp.php
index aeaf54c96..6d206d36c 100644
--- a/includes/mcp/class-convertkit-mcp.php
+++ b/includes/mcp/class-convertkit-mcp.php
@@ -95,6 +95,9 @@ public function __construct() {
 		// Register MCP resources (live-state lists, account, settings and reference docs).
 		add_filter( 'convertkit_resources', array( $this, 'register_mcp_resources' ) );
 
+		// Register MCP prompts (guided workflows).
+		add_filter( 'convertkit_prompts', array( $this, 'register_mcp_prompts' ) );
+
 		// Register settings get / update abilities for each Plugin settings
 		// These are owned by the Plugin (not by any single feature),
 		// so they're added here rather than via a per-class register_abilities().
@@ -243,6 +246,34 @@ public function register_mcp_resources( $resources ) {
 
 	}
 
+	/**
+	 * Appends the MCP prompts (guided workflows) to the convertkit_prompts
+	 * filter, so they are registered with the Abilities API and exposed as
+	 * MCP Prompts.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $prompts   Prompts to register.
+	 * @return  array
+	 */
+	public function register_mcp_prompts( $prompts ) {
+
+		$mcp_prompts = array(
+			new ConvertKit_MCP_Prompt_Setup(),
+			new ConvertKit_MCP_Prompt_Add_Form(),
+			new ConvertKit_MCP_Prompt_Restrict_Content(),
+			new ConvertKit_MCP_Prompt_Configure_Broadcasts_Import(),
+			new ConvertKit_MCP_Prompt_Audit(),
+		);
+
+		foreach ( $mcp_prompts as $prompt ) {
+			$prompts[ $prompt->get_name() ] = $prompt;
+		}
+
+		return $prompts;
+
+	}
+
 	/**
 	 * Register the 'kit' ability category.
 	 *
diff --git a/includes/mcp/prompts/class-convertkit-mcp-prompt-add-form.php b/includes/mcp/prompts/class-convertkit-mcp-prompt-add-form.php
new file mode 100644
index 000000000..0ac0e37ee
--- /dev/null
+++ b/includes/mcp/prompts/class-convertkit-mcp-prompt-add-form.php
@@ -0,0 +1,122 @@
+<?php
+/**
+ * Kit MCP Prompt: Add Form.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Guided workflow to show a Kit Form as a default, on a post or category, or
+ * inline in content. Produces a prompt named `kit/add-form`.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Prompt_Add_Form extends ConvertKit_MCP_Prompt {
+
+	/**
+	 * Returns the prompt's short name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_prompt_name() {
+
+		return 'add-form';
+
+	}
+
+	/**
+	 * Returns the prompt's label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Add a Kit Form', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'Show a Kit Form as a site default, on a single post or page, on a category, or inline in content.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's arguments.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_arguments() {
+
+		return array(
+			'form'  => array(
+				'description' => __( 'The Kit Form to add, by name or numeric ID.', 'convertkit' ),
+			),
+			'scope' => array(
+				'description' => __( 'Where to add it: default, post, category or inline.', 'convertkit' ),
+			),
+		);
+
+	}
+
+	/**
+	 * Returns the prompt text.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Prompt arguments.
+	 * @return  array|WP_Error
+	 */
+	public function execute_callback( $input ) {
+
+		$form  = isset( $input['form'] ) ? trim( (string) $input['form'] ) : '';
+		$scope = isset( $input['scope'] ) ? trim( (string) $input['scope'] ) : '';
+
+		$provided = array();
+		if ( '' !== $form ) {
+			/* translators: %s: Form name or ID. */
+			$provided[] = sprintf( __( '- Requested Form: %s', 'convertkit' ), $form );
+		}
+		if ( '' !== $scope ) {
+			/* translators: %s: scope. */
+			$provided[] = sprintf( __( '- Requested scope: %s', 'convertkit' ), $scope );
+		}
+
+		return $this->render(
+			array(
+				'# ' . __( 'Add a Kit Form', 'convertkit' ),
+				__( 'Goal: show a Kit Form as a site default, on a single post or page, on a category, or inline in content.', 'convertkit' ),
+				count( $provided ) ? implode( "\n", $provided ) : '',
+				'## ' . __( 'Preflight', 'convertkit' ),
+				__( '- Read `kit://forms` and map the requested Form to its numeric ID. If nothing matches, list the available Forms and ask the user.', 'convertkit' ),
+				__( '- See `kit://reference/forms` for how the Form shown on a post is resolved (post overrides category overrides the default).', 'convertkit' ),
+				'## ' . __( 'Choose the scope', 'convertkit' ),
+				__( '- **Default for a post type** — `kit/settings-general-update`.', 'convertkit' ),
+				__( '- **A single Page or Post** — `kit/post-settings-update`, setting `form` (needs `post_id`).', 'convertkit' ),
+				__( '- **A category** — `kit/category-settings-update`.', 'convertkit' ),
+				__( '- **Inline at a chosen position in the content** — `kit/form-insert`.', 'convertkit' ),
+				'## ' . __( 'Steps', 'convertkit' ),
+				__( '1. Confirm the Form and the scope with the user.', 'convertkit' ),
+				__( '2. Apply it with the matching tool above. Confirm before writing.', 'convertkit' ),
+				__( '3. Verify with the matching read tool (e.g. `kit/post-settings-get`).', 'convertkit' ),
+			)
+		);
+
+	}
+
+}
diff --git a/includes/mcp/prompts/class-convertkit-mcp-prompt-audit.php b/includes/mcp/prompts/class-convertkit-mcp-prompt-audit.php
new file mode 100644
index 000000000..cab224887
--- /dev/null
+++ b/includes/mcp/prompts/class-convertkit-mcp-prompt-audit.php
@@ -0,0 +1,87 @@
+<?php
+/**
+ * Kit MCP Prompt: Audit.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Guided, read-only workflow to review the Kit configuration and report gaps.
+ * Produces a prompt named `kit/audit`.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Prompt_Audit extends ConvertKit_MCP_Prompt {
+
+	/**
+	 * Returns the prompt's short name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_prompt_name() {
+
+		return 'audit';
+
+	}
+
+	/**
+	 * Returns the prompt's label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Audit Kit configuration', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'Review the Kit connection, default Forms and per-post settings, and report gaps and misconfigurations. Read only — makes no changes.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt text.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Prompt arguments (unused).
+	 * @return  array|WP_Error
+	 */
+	public function execute_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		return $this->render(
+			array(
+				'# ' . __( 'Audit Kit configuration', 'convertkit' ),
+				__( 'Goal: review the current Kit setup and report gaps. This is read only — do not change any settings; if the user wants a fix, point them to the relevant prompt (setup, add-form, restrict-content).', 'convertkit' ),
+				'## ' . __( 'Gather', 'convertkit' ),
+				__( '- `kit://account` — is the site connected?', 'convertkit' ),
+				__( '- `kit://settings` — default Forms, broadcasts and restrict-content configuration.', 'convertkit' ),
+				__( '- `kit://forms`, `kit://tags`, `kit://products` — what exists on the account.', 'convertkit' ),
+				__( '- For a sample of published Pages and Posts, `kit/post-settings-get` to see their Form / Landing Page / Tag / Restrict Content settings.', 'convertkit' ),
+				'## ' . __( 'Report', 'convertkit' ),
+				__( '- Whether the account is connected and which account it is.', 'convertkit' ),
+				__( '- Whether a default Form is set per post type, and which.', 'convertkit' ),
+				__( '- Content that references a Form, Tag or Product ID that no longer exists on the account.', 'convertkit' ),
+				__( '- Where Restrict Content is in use, and any content that looks like it should be gated but is not.', 'convertkit' ),
+				__( 'Summarise findings as a short list, most important first, with the suggested fix for each.', 'convertkit' ),
+			)
+		);
+
+	}
+
+}
diff --git a/includes/mcp/prompts/class-convertkit-mcp-prompt-configure-broadcasts-import.php b/includes/mcp/prompts/class-convertkit-mcp-prompt-configure-broadcasts-import.php
new file mode 100644
index 000000000..ed1410b31
--- /dev/null
+++ b/includes/mcp/prompts/class-convertkit-mcp-prompt-configure-broadcasts-import.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Prompt: Configure Broadcasts Import.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Guided workflow to set up importing Kit Broadcasts into WordPress as posts.
+ * Produces a prompt named `kit/configure-broadcasts-import`.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Prompt_Configure_Broadcasts_Import extends ConvertKit_MCP_Prompt {
+
+	/**
+	 * Returns the prompt's short name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_prompt_name() {
+
+		return 'configure-broadcasts-import';
+
+	}
+
+	/**
+	 * Returns the prompt's label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Import Kit Broadcasts as posts', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'Set up importing Kit Broadcasts (emails) into WordPress as posts, and how the imported posts are assigned.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt text.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Prompt arguments (unused).
+	 * @return  array|WP_Error
+	 */
+	public function execute_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		return $this->render(
+			array(
+				'# ' . __( 'Import Kit Broadcasts as posts', 'convertkit' ),
+				__( 'Goal: turn Kit Broadcasts (emails) into WordPress posts automatically, and control how those posts are assigned.', 'convertkit' ),
+				'## ' . __( 'Preflight', 'convertkit' ),
+				__( '- Read `kit://account` to confirm the site is connected, and `kit://settings` for the current broadcasts settings.', 'convertkit' ),
+				'## ' . __( 'Steps', 'convertkit' ),
+				__( '1. Ask the user whether to enable importing, and which author, category and post status imported posts should use (and whether to import the email thumbnail as the featured image).', 'convertkit' ),
+				__( '2. Apply with `kit/settings-broadcasts-update`. Confirm before writing.', 'convertkit' ),
+				__( '3. Verify with `kit/settings-broadcasts-get`.', 'convertkit' ),
+				__( 'Note: once enabled, importing runs automatically on a schedule — there is no manual "import now" step to call here.', 'convertkit' ),
+			)
+		);
+
+	}
+
+}
diff --git a/includes/mcp/prompts/class-convertkit-mcp-prompt-restrict-content.php b/includes/mcp/prompts/class-convertkit-mcp-prompt-restrict-content.php
new file mode 100644
index 000000000..243656b9e
--- /dev/null
+++ b/includes/mcp/prompts/class-convertkit-mcp-prompt-restrict-content.php
@@ -0,0 +1,118 @@
+<?php
+/**
+ * Kit MCP Prompt: Restrict Content.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Guided workflow to gate a post or page behind a Kit Product, Tag or Form.
+ * Produces a prompt named `kit/restrict-content`.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Prompt_Restrict_Content extends ConvertKit_MCP_Prompt {
+
+	/**
+	 * Returns the prompt's short name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_prompt_name() {
+
+		return 'restrict-content';
+
+	}
+
+	/**
+	 * Returns the prompt's label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Restrict content to subscribers', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'Gate a post or page so only subscribers or paying members can read it, using a Kit Product, Tag or Form.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's arguments.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  array
+	 */
+	protected function get_arguments() {
+
+		return array(
+			'post_id' => array(
+				'description' => __( 'The ID of the Page or Post to restrict.', 'convertkit' ),
+			),
+			'gate'    => array(
+				'description' => __( 'What to gate by: a Product, Tag or Form (name or ID).', 'convertkit' ),
+			),
+		);
+
+	}
+
+	/**
+	 * Returns the prompt text.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Prompt arguments.
+	 * @return  array|WP_Error
+	 */
+	public function execute_callback( $input ) {
+
+		$post_id = isset( $input['post_id'] ) ? trim( (string) $input['post_id'] ) : '';
+		$gate    = isset( $input['gate'] ) ? trim( (string) $input['gate'] ) : '';
+
+		$provided = array();
+		if ( '' !== $post_id ) {
+			/* translators: %s: Post ID. */
+			$provided[] = sprintf( __( '- Post to restrict: %s', 'convertkit' ), $post_id );
+		}
+		if ( '' !== $gate ) {
+			/* translators: %s: gate description. */
+			$provided[] = sprintf( __( '- Gate by: %s', 'convertkit' ), $gate );
+		}
+
+		return $this->render(
+			array(
+				'# ' . __( 'Restrict content to subscribers', 'convertkit' ),
+				__( 'Goal: gate a single post or page so only qualifying visitors see the full content. Read `kit://reference/restrict-content` first for how gating works and what the visitor sees.', 'convertkit' ),
+				count( $provided ) ? implode( "\n", $provided ) : '',
+				'## ' . __( 'Preflight', 'convertkit' ),
+				__( '- Decide what to gate by: a **Product** (paywall) from `kit://products`, a **Tag** from `kit://tags`, or a **Form** from `kit://forms`. Map the name to its numeric ID.', 'convertkit' ),
+				__( '- Confirm the target post ID with the user if not given.', 'convertkit' ),
+				'## ' . __( 'Steps', 'convertkit' ),
+				__( '1. Confirm the post and the gate with the user.', 'convertkit' ),
+				__( '2. Set it with `kit/post-settings-update`, supplying `restrict_content` (needs `post_id`). Confirm before writing.', 'convertkit' ),
+				__( '3. Verify with `kit/post-settings-get`.', 'convertkit' ),
+				__( 'Site wide behaviour (teaser, wording, login) lives in the restrict-content settings group — read `kit://settings` if the user wants to review it.', 'convertkit' ),
+			)
+		);
+
+	}
+
+}
diff --git a/includes/mcp/prompts/class-convertkit-mcp-prompt-setup.php b/includes/mcp/prompts/class-convertkit-mcp-prompt-setup.php
new file mode 100644
index 000000000..543a2f80e
--- /dev/null
+++ b/includes/mcp/prompts/class-convertkit-mcp-prompt-setup.php
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Kit MCP Prompt: Setup.
+ *
+ * @package ConvertKit
+ * @author ConvertKit
+ */
+
+/**
+ * Guided workflow to confirm the site is connected to Kit and set the default
+ * Form. Produces a prompt named `kit/setup`.
+ *
+ * @package ConvertKit
+ * @author  ConvertKit
+ */
+class ConvertKit_MCP_Prompt_Setup extends ConvertKit_MCP_Prompt {
+
+	/**
+	 * Returns the prompt's short name.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	protected function get_prompt_name() {
+
+		return 'setup';
+
+	}
+
+	/**
+	 * Returns the prompt's label.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_label() {
+
+		return __( 'Set up Kit', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt's description.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @return  string
+	 */
+	public function get_description() {
+
+		return __( 'Guided setup: confirm the site is connected to Kit, then choose the default Form shown on your content.', 'convertkit' );
+
+	}
+
+	/**
+	 * Returns the prompt text.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @param   array $input   Prompt arguments (unused).
+	 * @return  array|WP_Error
+	 */
+	public function execute_callback( $input ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
+
+		return $this->render(
+			array(
+				'# ' . __( 'Set up Kit', 'convertkit' ),
+				__( 'Goal: confirm the WordPress site is connected to a Kit account, then set sensible defaults. Read `kit://overview` first for how the pieces fit together.', 'convertkit' ),
+				'## ' . __( 'Preflight', 'convertkit' ),
+				__( '- Read `kit://account`. If it is empty, the site is not connected yet: tell the user to connect it under Settings > Kit in WordPress (this uses OAuth sign in and cannot be done over MCP), then stop until it is connected.', 'convertkit' ),
+				__( '- Read `kit://settings` for the current configuration and `kit://forms` for the available Forms.', 'convertkit' ),
+				'## ' . __( 'Steps', 'convertkit' ),
+				__( '1. Ask the user which Form should show by default, and on which post types. Use `kit://forms` to map the Form name to its numeric ID.', 'convertkit' ),
+				__( '2. Set the default Form(s) with `kit/settings-general-update`. Confirm the change with the user before applying it.', 'convertkit' ),
+				__( '3. Verify with `kit/settings-general-get`.', 'convertkit' ),
+			)
+		);
+
+	}
+
+}
diff --git a/tests/Integration/MCPPromptsTest.php b/tests/Integration/MCPPromptsTest.php
new file mode 100644
index 000000000..811abb888
--- /dev/null
+++ b/tests/Integration/MCPPromptsTest.php
@@ -0,0 +1,193 @@
+<?php
+
+namespace Tests;
+
+use lucatume\WPBrowser\TestCase\WPTestCase;
+
+/**
+ * Tests for the Kit MCP Prompt classes, registered via the `convertkit_prompts`
+ * filter and exposed by the MCP server as Prompts:
+ *
+ * - kit/setup
+ * - kit/add-form
+ * - kit/restrict-content
+ * - kit/configure-broadcasts-import
+ * - kit/audit
+ *
+ * @since   3.5.0
+ */
+class MCPPromptsTest extends WPTestCase
+{
+	/**
+	 * The testing implementation.
+	 *
+	 * @var \WpunitTester.
+	 */
+	protected $tester;
+
+	/**
+	 * Expected prompt name => class.
+	 *
+	 * @since   3.5.0
+	 *
+	 * @var     array<string, class-string>
+	 */
+	private const PROMPTS = array(
+		'kit/setup'                       => \ConvertKit_MCP_Prompt_Setup::class,
+		'kit/add-form'                    => \ConvertKit_MCP_Prompt_Add_Form::class,
+		'kit/restrict-content'            => \ConvertKit_MCP_Prompt_Restrict_Content::class,
+		'kit/configure-broadcasts-import' => \ConvertKit_MCP_Prompt_Configure_Broadcasts_Import::class,
+		'kit/audit'                       => \ConvertKit_MCP_Prompt_Audit::class,
+	);
+
+	/**
+	 * Performs actions before each test.
+	 *
+	 * @since   3.5.0
+	 */
+	public function setUp(): void
+	{
+		parent::setUp();
+
+		// Activate Plugin.
+		activate_plugins('convertkit/wp-convertkit.php');
+	}
+
+	/**
+	 * Performs actions after each test.
+	 *
+	 * @since   3.5.0
+	 */
+	public function tearDown(): void
+	{
+		// Restore the current user.
+		wp_set_current_user(0);
+
+		// Deactivate Plugin.
+		deactivate_plugins('convertkit/wp-convertkit.php');
+
+		parent::tearDown();
+	}
+
+	/**
+	 * Test that all prompts are registered with the `convertkit_prompts`
+	 * filter, so they are picked up by the Abilities API and exposed by the
+	 * MCP server.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testPromptsRegistered()
+	{
+		$prompts = convertkit_get_prompts();
+
+		foreach ( self::PROMPTS as $name => $class ) {
+			$this->assertArrayHasKey($name, $prompts);
+			$this->assertInstanceOf($class, $prompts[ $name ]);
+		}
+	}
+
+	/**
+	 * Test that each prompt advertises itself to the MCP Adapter as a prompt.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testPromptsAreMarkedAsPrompts()
+	{
+		$prompts = convertkit_get_prompts();
+
+		foreach ( self::PROMPTS as $name => $class ) {
+			$args = $prompts[ $name ]->get_ability_args();
+			$this->assertSame('prompt', $args['meta']['mcp']['type']);
+			$this->assertTrue($args['meta']['mcp']['public']);
+		}
+	}
+
+	/**
+	 * Test that each prompt returns non-empty text beginning with a heading.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testPromptsReturnText()
+	{
+		$prompts = convertkit_get_prompts();
+
+		foreach ( self::PROMPTS as $name => $class ) {
+			$result = $prompts[ $name ]->execute_callback([]);
+			$this->assertIsArray($result);
+			$this->assertArrayHasKey('text', $result);
+			$this->assertNotEmpty($result['text']);
+			$this->assertStringStartsWith('#', $result['text']);
+		}
+	}
+
+	/**
+	 * Test that the prompt permission callback requires the manage_options
+	 * capability: denied for an Editor, permitted for an Administrator.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testPromptsRequireManageOptions()
+	{
+		$prompts = convertkit_get_prompts();
+
+		// Editor is denied.
+		$editor_id = static::factory()->user->create([ 'role' => 'editor' ]);
+		wp_set_current_user($editor_id);
+		foreach ( array_keys( self::PROMPTS ) as $name ) {
+			$this->assertInstanceOf(\WP_Error::class, $prompts[ $name ]->permission_callback([]));
+		}
+
+		// Administrator is permitted.
+		$admin_id = static::factory()->user->create([ 'role' => 'administrator' ]);
+		wp_set_current_user($admin_id);
+		foreach ( array_keys( self::PROMPTS ) as $name ) {
+			$this->assertTrue($prompts[ $name ]->permission_callback([]));
+		}
+	}
+
+	/**
+	 * Test that prompts declaring arguments expose them in their input schema.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testPromptArgumentsInInputSchema()
+	{
+		$prompts = convertkit_get_prompts();
+
+		$addFormSchema = $prompts['kit/add-form']->get_input_schema();
+		$this->assertArrayHasKey('form', $addFormSchema['properties']);
+		$this->assertArrayHasKey('scope', $addFormSchema['properties']);
+
+		$restrictSchema = $prompts['kit/restrict-content']->get_input_schema();
+		$this->assertArrayHasKey('post_id', $restrictSchema['properties']);
+		$this->assertArrayHasKey('gate', $restrictSchema['properties']);
+	}
+
+	/**
+	 * Test that provided argument values are woven into the prompt text.
+	 *
+	 * @since   3.5.0
+	 */
+	public function testProvidedArgumentsAppearInPromptText()
+	{
+		$prompts = convertkit_get_prompts();
+
+		$addForm = $prompts['kit/add-form']->execute_callback(
+			[
+				'form'  => 'Weekly Newsletter',
+				'scope' => 'category',
+			]
+		);
+		$this->assertStringContainsString('Weekly Newsletter', $addForm['text']);
+		$this->assertStringContainsString('Requested scope: category', $addForm['text']);
+
+		$restrict = $prompts['kit/restrict-content']->execute_callback(
+			[
+				'post_id' => '12345',
+				'gate'    => 'Premium Membership',
+			]
+		);
+		$this->assertStringContainsString('12345', $restrict['text']);
+		$this->assertStringContainsString('Premium Membership', $restrict['text']);
+	}
+}
diff --git a/wp-convertkit.php b/wp-convertkit.php
index 067821936..0538c00c2 100644
--- a/wp-convertkit.php
+++ b/wp-convertkit.php
@@ -122,6 +122,11 @@
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-forms-reference.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-restrict-content-reference.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/resources/class-convertkit-mcp-resource-settings-reference.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/prompts/class-convertkit-mcp-prompt-setup.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/prompts/class-convertkit-mcp-prompt-add-form.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/prompts/class-convertkit-mcp-prompt-restrict-content.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/prompts/class-convertkit-mcp-prompt-configure-broadcasts-import.php';
+require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/prompts/class-convertkit-mcp-prompt-audit.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/class-convertkit-mcp.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/abilities/content/class-convertkit-mcp-ability-content.php';
 require_once CONVERTKIT_PLUGIN_PATH . '/includes/mcp/abilities/content/class-convertkit-mcp-ability-content-list.php';

From 7189bd70d8d1b5ff5fb41148d9ea4a9fe3fb8675 Mon Sep 17 00:00:00 2001
From: Tim Carr <tim@n7studios.co.uk>
Date: Wed, 9 Sep 2026 22:41:17 +0800
Subject: [PATCH 3/3] PHPStan compat.

---
 includes/class-convertkit-resource-account.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/includes/class-convertkit-resource-account.php b/includes/class-convertkit-resource-account.php
index c6de9568e..049af8065 100644
--- a/includes/class-convertkit-resource-account.php
+++ b/includes/class-convertkit-resource-account.php
@@ -118,7 +118,7 @@ public function refresh() {
 	 *
 	 * @since   3.4.0
 	 *
-	 * @return  array
+	 * @return  bool|array
 	 */
 	public function get() {