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] 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';