Strapi MCP Server

@misterboe

About Strapi MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "strapi": {
      "command": "npx",
      "args": [
        "-y",
        "@bschauer/[email protected]"
      ]
    }
  }
}

Tools

List all available Strapi servers from the configuration.

Get all content types from Strapi. Returns the complete schema of all content types.

Get all components from Strapi with pagination support. Returns both component data and pagination metadata (page, pageSize, total, pageCount).

Execute REST API requests against Strapi endpoints. IMPORTANT: All write operations (POST, PUT, DELETE) require explicit user authorization via the userAuthorized parameter. 1. Reading components: params: { populate: ['SEO'] } // Populate a component params: { populate: { SEO: { fields: ['Title', 'seoDescription'] } } } // With field selection 2. Updating components (REQUIRES USER AUTHORIZATION): body: { data: { // For single components: componentName: { Title: 'value', seoDescription: 'value' }, // For repeatable components: componentName: [ { field: 'value' } ] } } userAuthorized: true // Must set this to true for POST/PUT/DELETE after getting user permission 3. Other parameters: - fields: Select specific fields - filters: Filter results - sort: Sort results - pagination: Page through results

Upload media to Strapi's media library from a URL with format conversion, quality control, and metadata options. IMPORTANT: This is a write operation that REQUIRES explicit user authorization via the userAuthorized parameter.

Overview

What is Strapi MCP Server?

A Model Context Protocol server that enables AI assistants to interact with Strapi CMS through a standardized interface. It supports content type management, REST API operations, and media uploads, and is intended for development and learning purposes.

How to use Strapi MCP Server?

Install via npx and configure by creating a JSON file at ~/.mcp/strapi-mcp-server.config.json with your Strapi instance’s API URL and JWT token. Multiple Strapi instances can be added. Invoke MCP tools like strapi_get_content_types, strapi_rest, and strapi_upload_media to perform operations.

Key features of Strapi MCP Server

Schema introspection for content types and components
REST API with CRUD operations and validation
Media upload with image optimization (WebP, quality)
JWT authentication with token management
Write protection policy for security
Version compatibility for Strapi v4 and v5
Multiple server configuration support
Structured error handling and Zod validation

Use cases of Strapi MCP Server

AI assistant querying and filtering Strapi content types
Creating, updating, or deleting articles via natural language
Uploading and optimizing images to a Strapi media library
Managing multiple Strapi instances from a single interface

FAQ from Strapi MCP Server

How do I get a JWT token for authentication?

Log into your Strapi admin panel, create an API token with appropriate permissions, and add the token to your config file under the server name.

What Strapi versions are supported?

Both v4 and v5 are supported. The server automatically handles differences in IDs (numeric vs document-based), data structure, and JWT security.

Does this server work in production?

No. The software is provided as-is and should NOT be used in production without thorough testing. It may contain errors, security vulnerabilities, or unexpected behavior; use only for research, learning, or development.

What is the write protection policy?

All write operations (POST, PUT, DELETE, media upload) require explicit authorization. Each operation is logged and validated, and unauthorized writes are blocked.

What dependencies are required?

Node.js and npx. The server runs as an MCP tool via the command npx -y @bschauer/[email protected] and uses a local configuration file for credentials.

Frequently asked questions