Marketing Brain
by Felipe-Cal
README.md
# Marketing Brain MCP Server
A lightweight Model Context Protocol (MCP) server that acts as a "Marketing Brain," providing standardized brand guidelines and content templates.
## Features
- **Brand Voice Source of Truth**: Exposes the core brand guidelines (Voice, Audience, Constraints) through a simple tool.
- **Content Templates**: Provides structured templates for common marketing assets (Blog, Email, Social).
- **Extensible Design**: Uses a file-based system. Add or edit Markdown files in the `data/` directory to update strategies or add new ones without changing the code.
- **SSE Support**: Ready for cloud deployment via Server-Sent Events (SSE).
## Tools
### `get_content_strategy`
Returns the brand guidelines combined with a specific asset template.
- **Input**: `asset_type` (str) - e.g., `blog`, `email`, `social`.
## Project Structure
- `server.py`: The FastMCP server application.
- `data/brand_guidelines.md`: The global brand identity.
- `data/templates/`: Folder containing individual template files (one `.md` file per template).
---
## Installation & Usage
### 1. Cloud Deployment (Remote)
The server is optimized for deployment on platforms like **Railway** or **Render**.
Once deployed, you can connect your MCP client (like Claude Desktop) using the SSE endpoint:
```json
{
"mcpServers": {
"marketing-brain": {
"url": "https://marketing-brain-mcp.railway.app/sse"
}
}
}
```
### 2. Local Development
#### Prerequisites
- Python 3.10+
- `pip install fastmcp`
#### Running Locally (Stdio)
For local testing in your AI assistant:
```bash
fastmcp run server.py
```
#### Development Inspector
To test the tools in a web interface:
```bash
fastmcp dev server.py
```
### 3. Smithery
You can also install this server using the [Smithery](https://smithery.ai) CLI:
```bash
npx -y @smithery/cli install github.com/Felipe-Cal/marketing-brain-mcp --client claude
```
## License
MIT
TDQS
A3.5/5.0
Scored across 1 tool
Disambiguation5/5
Only one tool exists, so there is no risk of confusing it with another tool. The tool's purpose is clear and unambiguous.
Naming Consistency5/5
With a single tool, naming consistency is trivially maintained. The name 'get_content_strategy' follows a clear verb_noun pattern.
Tool Count2/5
The server is named 'Marketing Brain,' which implies a broad scope covering multiple marketing functions. Having only one tool is insufficient for this purpose, making the count too small.
Completeness1/5
A single 'get' operation is severely incomplete for a marketing strategy domain. Missing operations like create, update, delete, or analyze leave obvious gaps that agents cannot work around.
Maintenance
ActivityInactive
ResponsivenessNo issues