# 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