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

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

Related MCP server: Formswrite MCP

Configuration

Set the following environment variables:

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.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

Examples

Create a multiple choice question

{
  "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

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

Batch submit answers

{
  "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

# 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>.