{"id":2932,"date":"2026-09-01T08:41:55","date_gmt":"2026-09-01T08:41:55","guid":{"rendered":"https:\/\/kb.shortpixel.com\/?post_type=docs&#038;p=2932"},"modified":"2026-09-07T10:16:20","modified_gmt":"2026-09-07T10:16:20","password":"","slug":"shortpixel-ai-assistants-mcp","status":"publish","type":"docs","link":"https:\/\/kb.shortpixel.com\/knowledge-base\/article\/shortpixel-ai-assistants-mcp\/","title":{"rendered":"ShortPixel AI Assistants (MCP)"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Use ShortPixel with AI Assistants via MCP<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Connect <strong>ShortPixel Image Optimizer<\/strong> to AI assistants such as <strong>Cursor, OpenAI Codex, and Claude Desktop<\/strong> using the Model Context Protocol (MCP).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Once connected, you can manage many ShortPixel tasks using natural language. For example, you can ask your AI assistant to check your optimization status, view your remaining credits, optimize images, monitor processing queues, generate AI Image SEO metadata, or change supported ShortPixel settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This guide covers:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>What you can do with ShortPixel through MCP<\/li>\n\n\n\n<li>How to prepare your WordPress site<\/li>\n\n\n\n<li>How to connect your preferred AI assistant<\/li>\n\n\n\n<li>Example prompts you can start using immediately<\/li>\n\n\n\n<li>Security, permissions, and troubleshooting<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Who is this guide for?<\/strong><br>Site owners, agencies, and developers who want to manage ShortPixel from an AI assistant in addition to the WordPress admin interface.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">What is MCP?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>MCP (Model Context Protocol)<\/strong> is a standard that allows AI applications to discover and use specific tools provided by other applications.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">With ShortPixel and the WordPress MCP Adapter, your AI assistant can securely access ShortPixel abilities registered on your WordPress site.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The connection works like this:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>You<\/strong> (natural-language request) &gt; <strong>AI assistant<\/strong> (Cursor, Codex, Claude Desktop, etc.) &gt; <strong>MCP<\/strong> (WordPress MCP Adapter) &gt; <strong>ShortPixel abilities<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Instead of navigating through WordPress settings for every task, you can simply ask your assistant what you want to do.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>How many images are still unoptimized on my site?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">or:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Optimize image 1234 using glossy compression.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The assistant translates your request into the appropriate ShortPixel ability and runs it with the permissions of the WordPress user you connected.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Important:<\/strong> Your ShortPixel API key is never exposed to the AI assistant.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Step 1 \u2014 What can ShortPixel do through MCP?<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel registers a set of <strong>abilities<\/strong> with the WordPress Abilities API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When the WordPress MCP Adapter is active, compatible AI clients can discover these abilities and use them as MCP tools.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel MCP abilities fall into four main categories.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Monitor ShortPixel<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ability<\/th><th>What it does<\/th><\/tr><\/thead><tbody><tr><td><code>shortpixel\/get-stats<\/code><\/td><td>Shows optimization totals, average compression, and how many images still need optimization<\/td><\/tr><tr><td><code>shortpixel\/get-quota<\/code><\/td><td>Shows monthly, one-time, and AI credits and reports whether your quota has been exceeded<\/td><\/tr><tr><td><code>shortpixel\/get-media-status<\/code><\/td><td>Checks the optimization status of a specific image, including savings, compression, and backup information<\/td><\/tr><tr><td><code>shortpixel\/get-queue-status<\/code><\/td><td>Shows items waiting, processing, or completed in the Media Library and Custom Media queues<\/td><\/tr><tr><td><code>shortpixel\/get-settings<\/code><\/td><td>Shows supported ShortPixel settings. Sensitive information such as your API key is never returned<\/td><\/tr><tr><td><code>shortpixel\/get-ai-seo-status<\/code><\/td><td>Shows AI Image SEO information for a Media Library image, including alt text, caption, description, title, and filename<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">These abilities are read-only and are useful for checking the current state of your ShortPixel installation before making any changes.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Optimize and restore images<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ability<\/th><th>What it does<\/th><\/tr><\/thead><tbody><tr><td><code>shortpixel\/optimize-media<\/code><\/td><td>Optimizes a specific image, optionally using a selected compression level or SmartCrop. Uses optimization credits<\/td><\/tr><tr><td><code>shortpixel\/run-queue<\/code><\/td><td>Continues processing items currently waiting in the ShortPixel queues<\/td><\/tr><tr><td><code>shortpixel\/restore-media<\/code><\/td><td>Restores a specific image from its ShortPixel backup<\/td><\/tr><tr><td><code>shortpixel\/bulk-optimize<\/code><\/td><td>Starts optimization for all eligible unoptimized images. Requires explicit confirmation and uses optimization credits<\/td><\/tr><tr><td><code>shortpixel\/bulk-restore<\/code><\/td><td>Restores images from their ShortPixel backups in bulk. Requires explicit confirmation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Warning:<\/strong> Bulk restore replaces optimized versions with the original files stored in your ShortPixel backups. Use it only when you intentionally want to undo optimization.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Manage AI Image SEO<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">AI Image SEO abilities are available for images in the <strong>WordPress Media Library<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ability<\/th><th>What it does<\/th><\/tr><\/thead><tbody><tr><td><code>shortpixel\/generate-ai-seo<\/code><\/td><td>Generates supported AI Image SEO fields such as alt text, caption, description, and title, with optional filename generation. Uses AI credits<\/td><\/tr><tr><td><code>shortpixel\/undo-ai-seo<\/code><\/td><td>Restores AI SEO fields to their values before generation. Filename changes are not reverted<\/td><\/tr><tr><td><code>shortpixel\/bulk-generate-ai-seo<\/code><\/td><td>Generates AI Image SEO metadata for eligible Media Library images in bulk. Requires explicit confirmation<\/td><\/tr><tr><td><code>shortpixel\/bulk-undo-ai-seo<\/code><\/td><td>Undoes AI Image SEO changes across eligible Media Library images. Requires explicit confirmation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> AI Image SEO MCP abilities work with <strong>Media Library attachments only<\/strong>. They do not currently apply to Custom Media.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Change ShortPixel settings<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ability<\/th><th>What it does<\/th><\/tr><\/thead><tbody><tr><td><code>shortpixel\/update-settings<\/code><\/td><td>Changes supported ShortPixel settings such as compression, WebP\/AVIF generation, AI options, and resizing<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Only approved settings can be changed through MCP.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sensitive values such as your ShortPixel API key, credentials, and CDN domain cannot be modified through this ability.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">How processing jobs work<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Image optimization and AI Image SEO operations may continue after the initial MCP request.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A single call processes work for a limited amount of time. If items remain in the queue, your assistant can continue calling:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>shortpixel\/run-queue<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">until processing is complete.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For bulk operations, the assistant uses the bulk queue until all eligible items have been processed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can simply ask:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Keep processing the ShortPixel queue until it is empty.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You do not need to call the ability manually.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Step 2 \u2014 Prepare WordPress<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Before connecting an AI assistant, prepare your WordPress site for MCP access.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Requirements<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Make sure your site has:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>WordPress 6.9 or newer<\/strong><\/li>\n\n\n\n<li><strong>ShortPixel Image Optimizer<\/strong> version<strong> 6.6.0 or later<\/strong> installed and active<\/li>\n\n\n\n<li>A <strong>verified ShortPixel API key<\/strong><\/li>\n\n\n\n<li>The <strong>WordPress MCP Adapter<\/strong> installed and active<\/li>\n\n\n\n<li>A WordPress user account that you trust for AI access<\/li>\n\n\n\n<li>A site that can be reached from the machine where your AI client runs<\/li>\n\n\n\n<li>HTTPS enabled whenever possible<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">You can check your WordPress version under:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Dashboard \u2192 Updates<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter is-resized\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image-4-1024x521.png\" alt=\"WordPress version in Dashboard \u2192 Updates\" style=\"aspect-ratio:1.961803268873855;width:502px;height:auto\"\/><\/figure>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\"><em>Dashboard \u2192 Updates with WordPress 6.9 or newer.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can verify your ShortPixel API key under:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings \u2192 ShortPixel<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter is-resized\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image-5-1024x502.png\" alt=\"Verified ShortPixel API key\" style=\"aspect-ratio:2.0357220513776286;width:540px;height:auto\"\/><\/figure>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\"><em>Settings \u2192 ShortPixel. The API key must be verified before optimization abilities can run.<\/em><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> On WordPress versions older than 6.9, ShortPixel MCP abilities are not registered. ShortPixel itself continues to work normally through the WordPress interface.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2.1 \u2014 Install the WordPress MCP Adapter<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>WordPress MCP Adapter<\/strong> connects WordPress abilities to MCP-compatible AI applications.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To install it:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the <a href=\"https:\/\/github.com\/WordPress\/mcp-adapter\/releases\" rel=\"noopener\">WordPress MCP Adapter releases<\/a> page.<\/li>\n\n\n\n<li>Download the latest release ZIP.<\/li>\n\n\n\n<li>In WordPress, go to <strong>Plugins \u2192 Add New Plugin \u2192 Upload Plugin<\/strong>.<\/li>\n\n\n\n<li>Upload the ZIP.<\/li>\n\n\n\n<li>Click <strong>Install Now<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Activate<\/strong>.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">No additional ShortPixel-specific configuration is required.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Once both plugins are active, the MCP Adapter automatically discovers the ShortPixel abilities registered on your site.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Your default MCP endpoint will look like:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/YOUR-SITE\/wp-json\/mcp\/mcp-adapter-default-server\">https:\/\/YOUR-SITE\/wp-json\/mcp\/mcp-adapter-default-server<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Replace <code>YOUR-SITE<\/code> with your actual WordPress domain.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/example.com\/wp-json\/mcp\/mcp-adapter-default-server\" rel=\"noopener\">https:\/\/example.com\/wp-json\/mcp\/mcp-adapter-default-server<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If WordPress is installed in a subdirectory, include that path as well.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter is-resized\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image-3-1024x255.png\" alt=\"ShortPixel Image Optimizer and MCP Adapter active\" style=\"aspect-ratio:3.992202729044834;width:586px;height:auto\"\/><\/figure>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\"><em>ShortPixel Image Optimizer and MCP Adapter both active.<\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2.2 \u2014 Create a WordPress Application Password<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Your AI assistant needs permission to authenticate with WordPress.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For this, use a <strong>WordPress Application Password<\/strong> rather than your normal WordPress login password.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To create one:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>Users \u2192 Profile<\/strong>.<\/li>\n\n\n\n<li>If you want to use a different WordPress account, go to <strong>Users \u2192 All Users<\/strong> and edit that user instead.<\/li>\n\n\n\n<li>Scroll to <strong>Application Passwords<\/strong>.<\/li>\n\n\n\n<li>Enter a descriptive name, such as:<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><code>ShortPixel MCP \u2014 Cursor<\/code><\/p>\n\n\n\n<ol start=\"5\" class=\"wp-block-list\">\n<li>Click <strong>Add New Application Password<\/strong>.<\/li>\n\n\n\n<li>Copy the generated password immediately.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">WordPress displays the Application Password only when it is created.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Recommended:<\/strong> Create a separate Application Password for each AI client you connect\u2014for example, one for Cursor and another for Claude Desktop. This makes it easy to revoke access for one application without affecting the others.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the following information ready:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>You need<\/th><th>Example<\/th><\/tr><\/thead><tbody><tr><td><strong>Site URL<\/strong><\/td><td><code>https:\/\/example.com<\/code><\/td><\/tr><tr><td><strong>WordPress username<\/strong><\/td><td><code>admin<\/code><\/td><\/tr><tr><td><strong>Application Password<\/strong><\/td><td><code>xxxx xxxx xxxx xxxx xxxx xxxx<\/code><\/td><\/tr><tr><td><strong>MCP endpoint<\/strong><\/td><td><code>https:\/\/example.com\/wp-json\/mcp\/mcp-adapter-default-server<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image aligncenter is-resized\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image-2-1024x262.png\" alt=\"WordPress Application Passwords\" style=\"aspect-ratio:3.8863784617209274;width:572px;height:auto\"\/><\/figure>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\"><em>Users \u2192 Profile \u2192 Application Passwords.<\/em><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Security tip:<\/strong> Treat your Application Password like any other password. Do not publish it, commit it to a public repository, or include it in screenshots.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Which WordPress user should I use?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The abilities available to the AI assistant depend on the permissions of the WordPress user connected through the Application Password.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Administrator<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">An Administrator can use all supported ShortPixel MCP abilities, including reading and changing supported ShortPixel settings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Editor<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">An Editor can use ShortPixel abilities such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Statistics<\/li>\n\n\n\n<li>Quota information<\/li>\n\n\n\n<li>Image optimization<\/li>\n\n\n\n<li>Image restore<\/li>\n\n\n\n<li>AI Image SEO<\/li>\n\n\n\n<li>Queue management<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Editors cannot read or change ShortPixel settings through MCP.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong> Use the lowest WordPress role that provides the functionality you need.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Step 3 \u2014 Connect your AI assistant<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Once WordPress is ready, connect your preferred MCP-compatible AI client.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use the dedicated guide for your application:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>AI client<\/th><th>Setup guide<\/th><\/tr><\/thead><tbody><tr><td><strong>Cursor<\/strong><\/td><td><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-cursor-via-mcp\/\" rel=\"noopener\">Connect ShortPixel with Cursor via MCP<\/a><\/td><\/tr><tr><td><strong>OpenAI Codex<\/strong><\/td><td><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-openai-codex-via-mcp\/\" rel=\"noopener\">Connect ShortPixel with OpenAI Codex via MCP<\/a><\/td><\/tr><tr><td><strong>Claude Desktop<\/strong><\/td><td><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-claude-desktop-via-mcp\/\" rel=\"noopener\">Connect ShortPixel with Claude Desktop via MCP<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">All three clients connect to the same WordPress MCP endpoint and authenticate using a WordPress username and Application Password.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The main difference is how each application configures its MCP server.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After connecting, start a new conversation and ask:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What ShortPixel abilities are available on my WordPress site?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Your assistant should discover ShortPixel abilities under the:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>shortpixel\/<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">namespace.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>shortpixel\/get-stats<\/code><\/li>\n\n\n\n<li><code>shortpixel\/get-quota<\/code><\/li>\n\n\n\n<li><code>shortpixel\/optimize-media<\/code><\/li>\n\n\n\n<li><code>shortpixel\/generate-ai-seo<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Once you see those abilities, your ShortPixel MCP connection is ready to use.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Step 4 \u2014 Try these example prompts<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">You do not need to remember ShortPixel ability names.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ask your AI assistant what you want to accomplish in normal language, and it can select the appropriate ability.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Here are some useful prompts to get started.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Check optimization health<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ask your assistant<\/th><th>Ability used<\/th><\/tr><\/thead><tbody><tr><td><strong>How many images are optimized, and how many are left?<\/strong><\/td><td><code>get-stats<\/code><\/td><\/tr><tr><td><strong>Do I have enough ShortPixel credits to optimize all the remaining images?<\/strong><\/td><td><code>get-quota<\/code> + <code>get-stats<\/code><\/td><\/tr><tr><td><strong>Is image 1234 optimized, and how much space did it save?<\/strong><\/td><td><code>get-media-status<\/code><\/td><\/tr><tr><td><strong>What is the ShortPixel optimization queue doing right now?<\/strong><\/td><td><code>get-queue-status<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Optimize or restore an image<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ask your assistant<\/th><th>Ability used<\/th><\/tr><\/thead><tbody><tr><td><strong>Optimize image 1234 using glossy compression.<\/strong><\/td><td><code>optimize-media<\/code> + <code>run-queue<\/code> if needed<\/td><\/tr><tr><td><strong>Restore image 1234 from its ShortPixel backup.<\/strong><\/td><td><code>restore-media<\/code><\/td><\/tr><tr><td><strong>Keep processing the ShortPixel queue until it is empty.<\/strong><\/td><td><code>run-queue<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Run bulk operations<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ask your assistant<\/th><th>Ability used<\/th><\/tr><\/thead><tbody><tr><td><strong>Optimize all eligible unoptimized images and keep processing until the job is finished.<\/strong><\/td><td><code>bulk-optimize<\/code> + <code>run-queue<\/code><\/td><\/tr><tr><td><strong>Restore all images from their ShortPixel backups. I confirm that I want to undo the optimizations.<\/strong><\/td><td><code>bulk-restore<\/code> + <code>run-queue<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Important:<\/strong> Bulk optimization and bulk restore require explicit confirmation before they can start.<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\">Bulk restore should be used carefully because optimized files are replaced with their original backed-up versions.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Manage AI Image SEO<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ask your assistant<\/th><th>Ability used<\/th><\/tr><\/thead><tbody><tr><td><strong>Show me the AI SEO status for image 1234, including its alt text, caption, description, and title.<\/strong><\/td><td><code>get-ai-seo-status<\/code><\/td><\/tr><tr><td><strong>Generate AI alt text and a caption for image 1234.<\/strong><\/td><td><code>generate-ai-seo<\/code><\/td><\/tr><tr><td><strong>Undo the AI SEO changes for image 1234.<\/strong><\/td><td><code>undo-ai-seo<\/code><\/td><\/tr><tr><td><strong>Generate AI Image SEO metadata for all eligible Media Library images.<\/strong><\/td><td><code>bulk-generate-ai-seo<\/code> + <code>run-queue<\/code><\/td><\/tr><tr><td><strong>Undo AI Image SEO changes across the Media Library.<\/strong><\/td><td><code>bulk-undo-ai-seo<\/code> + <code>run-queue<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Remember that AI Image SEO MCP abilities currently work with <strong>Media Library images only<\/strong>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Review or change settings<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Ask your assistant<\/th><th>Ability used<\/th><\/tr><\/thead><tbody><tr><td><strong>What compression level am I using, and are WebP and AVIF enabled?<\/strong><\/td><td><code>get-settings<\/code><\/td><\/tr><tr><td><strong>Enable WebP creation and change compression to lossy.<\/strong><\/td><td><code>update-settings<\/code><\/td><\/tr><tr><td><strong>Enable AI Image SEO generation for alt text and captions.<\/strong><\/td><td><code>update-settings<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image.png\" alt=\"Example ShortPixel MCP conversation\"\/><\/figure>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img decoding=\"async\" src=\"https:\/\/kb.shortpixel.com\/wp-content\/uploads\/2026\/09\/image-1.png\" alt=\"Example ShortPixel MCP result\"\/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Security and permissions<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel&#8217;s MCP integration is designed so that the AI assistant receives access to specific ShortPixel abilities rather than unrestricted access to the plugin.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Important security points:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Your ShortPixel API key is never returned to the AI assistant.<\/strong><\/li>\n\n\n\n<li>ShortPixel settings that can be changed through MCP use a strict allowlist and validation.<\/li>\n\n\n\n<li>Sensitive ShortPixel fields such as API credentials and the CDN domain cannot be changed through MCP.<\/li>\n\n\n\n<li>Every ShortPixel action runs with the permissions of the WordPress user associated with the Application Password.<\/li>\n\n\n\n<li>Optimization and AI Image SEO operations still respect your ShortPixel credit limits.<\/li>\n\n\n\n<li>Bulk operations that can make significant changes require explicit confirmation.<\/li>\n\n\n\n<li>ShortPixel&#8217;s MCP abilities do not provide arbitrary PHP execution or direct filesystem access.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The WordPress MCP Adapter can also expose abilities registered by WordPress itself or by other compatible plugins. Those abilities have their own permissions and behavior.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Security recommendation:<\/strong> Create a dedicated Application Password for each AI client and revoke it as soon as that integration is no longer needed.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Troubleshooting<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\">No ShortPixel abilities appear<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Check that:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You are using WordPress 6.9 or newer<\/li>\n\n\n\n<li>ShortPixel Image Optimizer is active<\/li>\n\n\n\n<li>The WordPress MCP Adapter is active<\/li>\n\n\n\n<li>Your AI client&#8217;s MCP connection is running<\/li>\n\n\n\n<li>You are connecting to the correct MCP endpoint<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Your endpoint should normally look like:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/YOUR-SITE\/wp-json\/mcp\/mcp-adapter-default-server\">https:\/\/YOUR-SITE\/wp-json\/mcp\/mcp-adapter-default-server<\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">401, 403, or permission denied<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Check:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Your WordPress username<\/li>\n\n\n\n<li>Your WordPress Application Password<\/li>\n\n\n\n<li>The role and permissions of the connected WordPress user<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Make sure you are using an <strong>Application Password<\/strong>, not the user&#8217;s normal WordPress password.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">The MCP endpoint returns 404<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">First confirm that the WordPress MCP Adapter is active.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If it is, go to:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings \u2192 Permalinks<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">and save your permalink settings again.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Then retry the MCP connection.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u201cAPI key is not verified\u201d<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Go to:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Settings \u2192 ShortPixel<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">and make sure your ShortPixel API key is valid and verified.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\u201cQuota exceeded\u201d<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Your available ShortPixel credits have been exhausted.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can either add more credits or wait for the applicable quota to renew.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ask:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Show me my current ShortPixel quota.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">to see the current credit status.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">A job does not finish in one response<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This can be normal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Optimization and AI Image SEO jobs may need several processing cycles.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ask:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Keep processing the ShortPixel queue until it is empty.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The assistant can continue using <code>shortpixel\/run-queue<\/code> until processing is complete.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">AI Image SEO does not work with Custom Media<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This is expected.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The AI Image SEO MCP abilities currently support <strong>WordPress Media Library attachments only<\/strong>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">For developers \u2014 disable ShortPixel MCP abilities<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Developers can prevent ShortPixel from registering its MCP-compatible abilities without disabling ShortPixel Image Optimizer itself.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>add_filter( 'shortpixel\/abilities\/init', '__return_false' );<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel will continue to work normally through the WordPress admin interface.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Disconnect or disable MCP access<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">You can remove MCP access at different levels depending on what you want to disable.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Goal<\/th><th>What to do<\/th><\/tr><\/thead><tbody><tr><td><strong>Disconnect one AI client<\/strong><\/td><td>Revoke the Application Password used by that client<\/td><\/tr><tr><td><strong>Stop MCP access to the site<\/strong><\/td><td>Deactivate the WordPress MCP Adapter<\/td><\/tr><tr><td><strong>Keep MCP active but hide ShortPixel abilities<\/strong><\/td><td>Use the <code>shortpixel\/abilities\/init<\/code> filter shown above<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Revoking an Application Password does not change the WordPress user&#8217;s normal password.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">ShortPixel also continues to work normally through the WordPress admin interface after MCP access is disabled.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Next steps<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Your WordPress site is now ready to use ShortPixel with an MCP-compatible AI assistant.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Choose your client and continue with its setup guide:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-cursor-via-mcp\/\" rel=\"noopener\"><strong>Connect ShortPixel with Cursor via MCP<\/strong><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-openai-codex-via-mcp\/\" rel=\"noopener\"><strong>Connect ShortPixel with OpenAI Codex via MCP<\/strong><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/shortpixel.com\/knowledge-base\/article\/connect-shortpixel-with-claude-desktop-via-mcp\/\" rel=\"noopener\"><strong>Connect ShortPixel with Claude Desktop via MCP<\/strong><\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Once connected, start with a simple read-only request:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Show me my ShortPixel optimization statistics, remaining credits, and current queue status.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">From there, you can use natural language to manage optimization, AI Image SEO, and supported ShortPixel settings directly from your AI assistant.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Use ShortPixel with AI Assistants via MCP Connect ShortPixel Image Optimizer to AI assistants such as Cursor, OpenAI Codex, and Claude Desktop using the Model Context Protocol (MCP). Once connected, you can manage many ShortPixel tasks using natural language. For example, you can ask your AI assistant to check your optimization status, view your remaining [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[64],"glossaries":[],"doc_tag":[],"class_list":["post-2932","docs","type-docs","status-publish","hentry","doc_category-mcp"],"blocksy_meta":[],"year_month":"2026-09","word_count":2311,"total_views":"21","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"admin","author_nicename":"admin_mdli53m5","author_url":"https:\/\/kb.shortpixel.com\/author\/admin_mdli53m5\/"},"doc_category_info":[{"term_name":"MCP","term_url":"https:\/\/kb.shortpixel.com\/knowledge-base\/category\/mcp\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2932","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/comments?post=2932"}],"version-history":[{"count":12,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2932\/revisions"}],"predecessor-version":[{"id":2978,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/docs\/2932\/revisions\/2978"}],"wp:attachment":[{"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/media?parent=2932"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/doc_category?post=2932"},{"taxonomy":"glossaries","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/glossaries?post=2932"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/kb.shortpixel.com\/wp-json\/wp\/v2\/doc_tag?post=2932"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}