# B2Brilliant MCP Server

Model Context Protocol (MCP) server for the [B2Brilliant Campaign Agent API](https://github.com/Liquidbuiltit/B2brilliant-sdk).

## Quick Start

1. **Install globally from NPM:**
   ```bash
   npm install -g b2brilliant-mcp-server
   ```

2. **Set your API key:**
   ```bash
   export B2BRILLIANT_API_KEY=your_api_key_here
   ```

3. **Run the server:**
   ```bash
   b2brilliant-mcp
   ```

## Available Tools

### User Business Tools
- `discover_user_business` - Analyze your business from website URLs
- `refine_user_business` - Refine your business information with feedback

### Target Business Tools  
- `discover_business` - Analyze target business from website URLs
- `refine_business` - Refine target business information with feedback
- `check_compatibility` - Assess compatibility between businesses

### Campaign Tools
- `create_campaign` - Generate marketing campaigns for target business
- `refine_campaign` - Improve campaigns based on feedback

## Configuration

The server requires a B2Brilliant API key set as an environment variable:

```bash
export B2BRILLIANT_API_KEY=your_api_key_here
```

Get your API key by signing up for beta access at [B2Brilliant.app](https://b2brilliant.app).

## Development Setup

If you want to contribute or work with the source code:

1. **Clone the repository and navigate to the MCP package:**
   ```bash
   cd pkg/mcp
   ```

2. **Install dependencies:**
   ```bash
   npm install
   ```

3. **Build the project:**
   ```bash
   npm run build
   ```

4. **Run tests:**
   ```bash
   npm test
   ```

5. **Run locally:**
   ```bash
   npm start
   ```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "b2brilliant": {
      "command": "b2brilliant-mcp",
      "env": {
        "B2BRILLIANT_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Example Workflow

1. **Discover your business:**
   ```
   Use discover_user_business with your website URL
   ```

2. **Find target business:**
   ```
   Use discover_business with target company URL
   ```

3. **Check compatibility:**
   ```
   Use check_compatibility with both business objects
   ```

4. **Create campaign:**
   ```
   Use create_campaign to generate personalized outreach
   ```