npm package: @offlinemediainc/creator-mcp
Description: MCP server for Creator management platform
Latest version: 0.1.0

# Creator MCP Server

A Model Context Protocol (MCP) server for managing shoots in the Creator platform.

## Features

- List shoots with filters (status, creator)
- Get detailed shoot information
- Create new draft shoots

## Installation

### For Users

Install from npm:
```bash
npm install -g @offlinemediainc/creator-mcp
```

Or use directly with npx (recommended):
```bash
npx @offlinemediainc/creator-mcp
```

### For Development

```bash
git clone [repository-url]
cd mcp-server
npm install
npm run build
```

## Configuration

### 1. Get an API Key

1. Log into the Creator app as an admin
2. Go to Settings → API Keys
3. Click "Generate New Key"
4. Copy the generated key (save it securely!)

### 2. Configure Claude Desktop

Add to your Claude Desktop configuration file:
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "creator": {
      "command": "npx",
      "args": ["-y", "@offlinemediainc/creator-mcp"],
      "env": {
        "API_URL": "https://creators.letsgetoffline.com",
        "CREATOR_API_KEY": "creator_abc123xyz..."
      }
    }
  }
}
```

### 3. Environment Variables

- `API_URL`: The URL of your Creator app (defaults to https://creators.letsgetoffline.com)
- `CREATOR_API_KEY`: Your API key from the Creator app settings

## Available Tools

### shoots_list
List shoots with optional filters.

Parameters:
- `status` (optional): Filter by status (draft, available, in_progress, under_review, needs_revision, awaiting_payment, complete, problem)
- `creatorId` (optional): Filter by creator ID
- `limit` (optional): Maximum number of results (default: 50)

### shoots_get
Get detailed information about a specific shoot.

Parameters:
- `shootId` (required): The UUID of the shoot

### shoots_create
Create a new shoot (always creates as draft status).

Parameters:
- `dealName` (required): Name of the business/partner
- `dueDate` (optional): Due date (YYYY-MM-DD) - defaults to 2 weeks from today
- `market` (optional): Market name (Austin, Charlotte, Columbus, Denver, Durham, Indianapolis, Nashville, Orlando, Raleigh, San Antonio, Tampa Bay)
- `address` (optional): Street address
- `city` (optional): City
- `state` (optional): State
- `zipCode` (optional): ZIP code
- `type` (optional): Shoot type
- `website` (optional): Website URL
- `instagramHandle` (optional): Instagram handle
- `notes` (optional): Additional notes or context
- `partnerContactName` (optional): Partner contact name
- `partnerContactEmail` (optional): Partner contact email
- `partnerContactPhone` (optional): Partner contact phone
- `partnerContactTitle` (optional): Partner contact title
- `cost` (optional): Shoot cost in dollars (default: 100)

## Security

This MCP server requires authentication via API keys. Without a valid API key, the server will not start or provide access to any data.

## Publishing

To publish to npm:
```bash
npm version patch  # or minor/major
npm publish --access public
```

## Testing

Test locally with the MCP Inspector:
```bash
npx @modelcontextprotocol/inspector dist/index.js
```

## License

MIT