# OG:IMAGE MCP Server

Generate beautiful OG images directly from Claude Desktop using [ogimage.art](https://ogimage.art).

## Installation

### Option 1: npx (Recommended)

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "ogimage": {
      "command": "npx",
      "args": ["-y", "ogimage-mcp"]
    }
  }
}
```

### Option 2: Global Install

```bash
npm install -g ogimage-mcp
```

Then add to Claude Desktop config:

```json
{
  "mcpServers": {
    "ogimage": {
      "command": "ogimage-mcp"
    }
  }
}
```

## Usage

Once installed, you can ask Claude to generate OG images:

> "Generate an OG image for my blog post titled 'How to Build a SaaS in 2024'"

> "Create a dark-themed OG image with the title 'API Documentation' and subtitle 'Getting Started Guide'"

> "List available OG image templates"

## Available Tools

### generate_og_image

Generate an OG image URL.

**Parameters:**
- `title` (required): Main title text
- `subtitle`: Optional subtitle
- `author`: Optional author name
- `template`: gradient, dark, sunset, ocean, forest, midnight, fire, minimal
- `size`: 1200x630, 1200x675, 800x418
- `key`: License key to remove watermark

### list_templates

List all available templates and sizes.

### get_meta_tag

Generate the HTML meta tag for any URL.

## Pro Version

Free tier includes a small watermark. Get a Pro license at [ogimage.art](https://ogimage.art) to:
- Remove watermarks
- Access premium templates
- Use in commercial projects

Add your license key to remove watermarks:

> "Generate an OG image with title 'My Post' using my key ABC123"

## Examples

**Basic:**
```
> Generate an OG image with title "Hello World"
```

**With options:**
```
> Create an OG image:
  - Title: "Building APIs"
  - Subtitle: "A Complete Guide"
  - Template: dark
  - Author: "John Doe"
```

## Links

- Website: [ogimage.art](https://ogimage.art)
- Get Pro: [ogimage.art/#pricing](https://ogimage.art/#pricing)
- npm Package: [ogimage-mcp](https://www.npmjs.com/package/ogimage-mcp)

## License

MIT