🚀 Strapi MCP Server

A production-ready Strapi v5 application that acts as a Model Context Protocol (MCP) server for marketing and SEO integrations. This project provides extensible, AI-compatible endpoints for integrating services like Google Search Console and Meta Ads into automated workflows.

📌 Overview

This server enables AI agents and external tools to interact with marketing platforms through standardized MCP endpoints. It is designed for scalability, modularity, and real-world automation use cases.

Key Capabilities

• 🔌 MCP-compliant API endpoints (/api/mcp/*)

• 🧠 AI-agent ready tool registry

• 🔐 Authentication & session management

• ⚡ Rate limiting & streaming support

• 🧩 Plugin-based architecture

• 🗂️ Built-in CMS (Articles, Authors, Categories, etc.)

Related MCP server: Strapi MCP Suite

🧩 Core Plugins

1. GSC MCP (Google Search Console)

Provides tools for SEO automation:

• Site management

• Sitemap submission & deletion

• URL inspection

• Indexing status checks

• Health monitoring

2. Meta MCP (Meta Ads: Facebook & Instagram)

Supports marketing automation workflows:

• Campaign insights

• Ads data integration

• Performance tracking

🛠️ Tech Stack

• Strapi v5.42.0

• Node.js (v20 – v24)

• @modelcontextprotocol/sdk v1.29.0

• better-sqlite3 (default database)

• Winston (logging)

• Zod (validation)

⚙️ Getting Started

Prerequisites

• Node.js >= 20 <= 24

• Yarn or NPM

Installation

git clone <your-repo-url>
cd strapi-mcp-server
yarn install

Development

yarn develop

• Admin Panel: http://localhost:1337/admin

• MCP Endpoints: http://localhost:1337/api/mcp/*

Production

yarn build
yarn start

🌱 Seeding Data

Populate the CMS with sample content:

yarn seed:example

📁 Project Structure

src/
├── plugins/
│   ├── gsc-mcp/
│   │   ├── controllers/
│   │   ├── services/
│   │   ├── routes/
│   │   └── utils/
│   └── meta-mcp/
│       ├── controllers/
│       ├── services/
│       └── utils/
│
├── api/
│   ├── article/
│   ├── author/
│   └── category/
│
config/
├── plugins.ts

🔐 Configuration

Both MCP plugins are enabled via:

config/plugins.ts

Environment Variables

You must configure credentials for external services:

• Google Search Console API credentials

• Meta Ads API credentials

Example:

GSC_CLIENT_ID=your_key
GSC_CLIENT_SECRET=your_secret
META_ACCESS_TOKEN=your_token

🤖 MCP Integration

This server exposes MCP-compatible endpoints that allow AI agents to:

• Discover available tools

• Execute SEO and marketing actions

• Automate workflows programmatically

Example Use Cases

• Automated sitemap submission

• SEO health monitoring bots

• Ads performance reporting

• AI-driven marketing automation

Refer to the MCP SDK documentation for client integration details.

📜 Available Scripts

🧪 Development Workflow

1. Fork the repository

2. Install dependencies

3. Run the development server

4. Add or extend MCP tools inside plugins

5. Test endpoints via /api/mcp/*

📈 Future Improvements

• Additional marketing integrations

• Advanced analytics tools

• Role-based access control for MCP tools

• Multi-tenant support

🤝 Contributing

Contributions are welcome!

1. Fork the repo

2. Create a feature branch

3. Commit your changes

4. Open a pull request

📄 License

MIT License

💡 Summary

This project bridges AI systems with marketing platforms using the MCP standard—making it easy to build intelligent, automated SEO and advertising workflows on top of Strapi.