# Profile Questions MCP Server

An MCP (Model Context Protocol) server that allows AI agents to interact with the White Rabbit Profile Questions API. This enables agents to create questions, submit answers, and query existing profile data.

## Installation

```bash
cd mcp-servers/profile-questions
npm install
npm run build
```

## Configuration

Set the following environment variables:

| Variable | Description | Default |
|----------|-------------|---------|
| `PROFILE_QUESTIONS_API_URL` | Base URL of the White Rabbit API | `http://localhost:3000` |
| `PROFILE_QUESTIONS_API_KEY` | API key for authentication | (none) |

## Usage with Claude Desktop

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

```json
{
  "mcpServers": {
    "profile-questions": {
      "command": "node",
      "args": ["/path/to/mcp-servers/profile-questions/dist/index.js"],
      "env": {
        "PROFILE_QUESTIONS_API_URL": "https://your-api-url.com",
        "PROFILE_QUESTIONS_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Available Tools

### list_questions

List profile questions by source.

**Parameters:**
- `source` (required): `profile_optimizer` | `admin` | `onboarding` | `survey`
- `category` (optional): Filter by category
- `questionType` (optional): `free_form` | `multiple_choice` | `yes_no` | `fill_in_blank`
- `activeOnly` (optional): Only return active questions (default: true)
- `page` (optional): Page number (0-indexed)
- `limit` (optional): Items per page (default: 50)

### create_question

Create a new profile question.

**Parameters:**
- `questionText` (required): The question text (1-500 characters)
- `questionType` (required): `free_form` | `multiple_choice` | `yes_no` | `fill_in_blank`
- `source` (required): `profile_optimizer` | `admin` | `onboarding` | `survey`
- `description` (optional): Description for the question (max 1000 characters)
- `options` (required for multiple_choice): Array of at least 2 options
- `allowMultiple` (optional): Allow selecting multiple options (default: false)
- `fillInBlankTemplate` (required for fill_in_blank): Template containing `{blank}` placeholder
- `category` (optional): Category for organizing questions (max 100 characters)
- `displayOrder` (optional): Order for displaying questions (default: 0)
- `isActive` (optional): Whether the question is active (default: true)

### get_my_answers

Get the current user's answers to profile questions.

**Parameters:**
- `source` (optional): Filter answers by source

### submit_answer

Submit an answer to a profile question.

**Parameters:**
- `questionId` (required): UUID of the question to answer
- `answerSource` (required): `profile_optimizer` | `admin` | `onboarding` | `survey`
- `textValue` (optional): For free_form or fill_in_blank questions
- `booleanValue` (optional): For yes_no questions (true/false)
- `selectedOptions` (optional): For multiple_choice questions

### batch_submit_answers

Submit multiple answers at once (up to 50).

**Parameters:**
- `answers` (required): Array of answer objects (same structure as submit_answer)

## Question Types

| Type | Answer Field | Description |
|------|--------------|-------------|
| `free_form` | `textValue` | Open-ended text responses |
| `multiple_choice` | `selectedOptions` | Select from predefined options |
| `yes_no` | `booleanValue` | Binary true/false |
| `fill_in_blank` | `textValue` | Complete a sentence template |

## Examples

### Create a multiple choice question

```json
{
  "tool": "create_question",
  "arguments": {
    "questionText": "What is your experience level with AI tools?",
    "questionType": "multiple_choice",
    "options": ["Beginner", "Intermediate", "Advanced", "Expert"],
    "source": "profile_optimizer",
    "category": "skills"
  }
}
```

### Submit an answer

```json
{
  "tool": "submit_answer",
  "arguments": {
    "questionId": "123e4567-e89b-12d3-a456-426614174000",
    "selectedOptions": ["Advanced"],
    "answerSource": "profile_optimizer"
  }
}
```

### Batch submit answers

```json
{
  "tool": "batch_submit_answers",
  "arguments": {
    "answers": [
      {
        "questionId": "uuid-1",
        "selectedOptions": ["Advanced"],
        "answerSource": "profile_optimizer"
      },
      {
        "questionId": "uuid-2",
        "textValue": "I have 5 years of experience",
        "answerSource": "profile_optimizer"
      }
    ]
  }
}
```

## Development

```bash
# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start
```

## Authentication

The server uses bearer token authentication. Set your API key via the `PROFILE_QUESTIONS_API_KEY` environment variable. The key is passed in the `Authorization` header as `Bearer <key>`.