Skip to main content
Glama
Felipe-Cal
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