npm package: @katspeax/alchemist-mcp
Description: MCP server for KatSpeax Alchemist — give AI assistants creative superpowers
Latest version: 0.1.0

# @katspeax/alchemist-mcp

MCP (Model Context Protocol) server for the KatSpeax Alchemist API. Gives AI assistants like Claude and GPT direct access to the Alchemist creative pipeline -- generate content, design products, clone voices, edit video, audit brand voice, and push to e-commerce. All through natural tool calls.

## Install

```bash
npm install -g @katspeax/alchemist-mcp
```

## Configuration

### Claude Code / Claude Desktop

Add to your MCP settings (`.claude/settings.json` or Claude Desktop config):

```json
{
  "mcpServers": {
    "alchemist": {
      "command": "npx",
      "args": ["@katspeax/alchemist-mcp"],
      "env": {
        "ALCHEMIST_API_KEY": "ks_live_..."
      }
    }
  }
}
```

### Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `ALCHEMIST_API_KEY` | Yes | — | API key (starts with `ks_live_` or `ks_test_`) |
| `ALCHEMIST_API_URL` | No | `https://api.katspeax.com` | API base URL |

## Available Tools

### Content Core

| Tool | Description |
|------|-------------|
| `generate_content` | Generate truth-grade content from a creative prompt |
| `refine_content` | Refine content with a direction ("more tender", "shorter") |
| `score_content` | Score content for voice alignment and quality |

### Design

| Tool | Description |
|------|-------------|
| `design_product` | Generate a product design from content and product type |
| `render_design` | Render a design to SVG, PNG, or PDF files |

### Voice

| Tool | Description |
|------|-------------|
| `generate_speech` | Convert text to speech audio |
| `clone_voice` | Clone a voice from a sample and synthesize speech |

### Video

| Tool | Description |
|------|-------------|
| `edit_video` | Edit a video using natural language instructions |
| `reframe_video` | Reframe a video to a different aspect ratio |

### Content

| Tool | Description |
|------|-------------|
| `repurpose_content` | Repurpose content for multiple social platforms |

### Commerce

| Tool | Description |
|------|-------------|
| `create_listing` | Create an e-commerce listing (Etsy, Amazon, Shopify, Printify) |

### Brand

| Tool | Description |
|------|-------------|
| `audit_voice` | Audit text against brand voice rules (banned words, patterns, AI scoring) |
| `get_brand_config` | Get current brand configuration (voice, colors, fonts) |

## Available Resources

| URI | Description |
|-----|-------------|
| `alchemist://brand/config` | Brand voice rules, colors, fonts, banned words |
| `alchemist://content/library` | All truths and content entries |
| `alchemist://products/catalog` | Product catalog with statuses and configs |
| `alchemist://api/usage` | API usage stats and remaining credits |

## Usage Example

Once configured, ask Claude:

> "Generate a spoken word piece about grief and grace, then design it as a greeting card and create an Etsy listing."

Claude will call `generate_content`, `design_product`, and `create_listing` in sequence.

## License

MIT