# AdCraft MCP Server
MCP server for AI-powered ad copy generation. Wraps AdCraft's ad copy API for use with Claude and other MCP-compatible AI assistants.
## Features
- **Platform-optimized copy** for Facebook, Google Ads, and LinkedIn
- **Multiple tones**: professional, casual, urgent, friendly, luxury
- **Smart keyword extraction** from product descriptions
- **Platform-specific formatting** and character guidelines
## Installation
```bash
npm install
npm run build
```
## Usage
### As MCP Server
Add to your Claude Desktop config (`~/.claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"adcraft": {
"command": "node",
"args": ["/path/to/adcraft-mcp/dist/index.js"]
}
}
}
```
### Tool: `generate_ad_copy`
Generate platform-optimized ad copy for products.
**Inputs:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_name` | string | ✓ | Product or service description (e.g., "organic skincare products") |
| `target_audience` | string | ✓ | Target audience (e.g., "professional women aged 25-45") |
| `platform` | string | ✓ | One of: `facebook`, `google`, `linkedin` |
| `tone` | string | | One of: `professional`, `casual`, `urgent`, `friendly`, `luxury` (default: professional) |
**Example:**
```
Generate ad copy for "premium SaaS marketing platform" targeting "small business owners" on LinkedIn with a professional tone
```
**Output:**
```json
{
"platform": "linkedin",
"tone": "professional",
"headline": "How entrepreneurs Achieve marketing success with Our software",
"description": "Our software helps small business owners achieve measurable marketing success...",
"cta": "Schedule Demo",
"formatted": "How entrepreneurs Achieve marketing success...\n\nOur software helps...\n\nSchedule Demo →",
"guidelines": {
"maxHeadline": 150,
"maxDescription": 300,
"style": "professional, value-driven, industry-focused"
},
"timestamp": "2024-02-08T11:30:00.000Z"
}
```
## Platform Guidelines
| Platform | Max Headline | Max Description | Style |
|----------|--------------|-----------------|-------|
| Facebook | 25 chars | 125 chars | Emotional, visual-focused |
| Google | 30 chars | 90 chars | Direct, action-oriented |
| LinkedIn | 150 chars | 300 chars | Professional, value-driven |
## Development
```bash
# Run in development mode
npm run dev
# Run tests
npm test
# Build for production
npm run build
```
## License
MIT
