# ProofBase MCP Server

An MCP (Model Context Protocol) server for generating realistic customer testimonials using AI. Part of the ProofBase testimonial management ecosystem.

## Features

- **AI-Powered Generation**: Uses Claude to create authentic-sounding testimonials
- **Customizable Tone**: Choose between professional, casual, or enthusiastic styles
- **Flexible Output**: Includes customer name, role, company, avatar, and rating
- **Metric Support**: Optionally include specific metrics for credibility

## Installation

```bash
npm install proofbase-mcp
```

Or install from source:

```bash
git clone <repo>
cd mcp-servers/proofbase-mcp
npm install
npm run build
```

## Configuration

Set your Anthropic API key:

```bash
export ANTHROPIC_API_KEY=your-key-here
```

## Usage with Claude Desktop

Add to your Claude Desktop configuration (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "proofbase": {
      "command": "node",
      "args": ["/path/to/proofbase-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}
```

## Available Tools

### generate_testimonial

Generate a realistic customer testimonial.

**Inputs:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_name` | string | ✅ | Name of the product |
| `customer_type` | string | ✅ | Type of customer (e.g., "SaaS founder", "Marketing manager") |
| `outcome` | string | ✅ | Key benefit to highlight (e.g., "increased conversions") |
| `tone` | string | ❌ | One of: "professional", "casual", "enthusiastic" (default: professional) |
| `include_metrics` | boolean | ❌ | Whether to include specific numbers (default: true) |

**Example Output:**

```json
{
  "name": "Sarah Chen",
  "role": "Head of Marketing",
  "company": "Flowstate",
  "avatar": "SC",
  "text": "ProofBase completely transformed how we showcase customer love. Our conversion rate jumped 34% after adding the wall of love to our landing page.",
  "rating": 5
}
```

## Example Usage

```
User: Generate a testimonial for ProofBase from a startup founder who saw increased conversions

Tool Call: generate_testimonial
{
  "product_name": "ProofBase",
  "customer_type": "startup founder",
  "outcome": "increased conversions",
  "tone": "enthusiastic"
}

Result:
{
  "name": "Marcus Johnson",
  "role": "Founder & CEO",
  "company": "Launchpad.io",
  "avatar": "MJ",
  "text": "Game-changer! We added ProofBase testimonials to our landing page and saw a 47% lift in signups within the first week. The setup was ridiculously easy.",
  "rating": 5
}
```

## Development

```bash
# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test
```

## Testing

```bash
# Run unit tests
npm test

# Test the server manually
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
```

## License

MIT