Profile Questions MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Profile Questions MCP Server list my unanswered profile questions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildRelated MCP server: Filly Forms MCP Server
Configuration
Set the following environment variables:
Variable | Description | Default |
| Base URL of the White Rabbit API |
|
| API key for authentication | (none) |
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|surveycategory(optional): Filter by categoryquestionType(optional):free_form|multiple_choice|yes_no|fill_in_blankactiveOnly(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_blanksource(required):profile_optimizer|admin|onboarding|surveydescription(optional): Description for the question (max 1000 characters)options(required for multiple_choice): Array of at least 2 optionsallowMultiple(optional): Allow selecting multiple options (default: false)fillInBlankTemplate(required for fill_in_blank): Template containing{blank}placeholdercategory(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 answeranswerSource(required):profile_optimizer|admin|onboarding|surveytextValue(optional): For free_form or fill_in_blank questionsbooleanValue(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 |
|
| Open-ended text responses |
|
| Select from predefined options |
|
| Binary true/false |
|
| Complete a sentence template |
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 startAuthentication
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>.
Available Tools
5 toolsbatch_submit_answersB
Submit multiple answers at once (up to 50). Useful for completing questionnaires.
Inputs: answers (required).
create_questionC
Create a new profile question. Questions can be free-form text, multiple choice, yes/no, or fill-in-the-blank.
Inputs: source (required), questionText (required), questionType (required), options, +6 more.
get_my_answersB
Get the current user's answers to profile questions. Requires authentication.
Inputs: source.
list_questionsA
List profile questions by source. Use this to discover available questions before submitting answers.
Inputs: source (required), page, limit, category, +2 more.
submit_answerC
Submit an answer to a profile question. The answer type must match the question type.
Inputs: questionId (required), answerSource (required), textValue, booleanValue, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct resource-action pair: get_my_answers (retrieve user answers), list_questions (discover questions), create_question (author questions), submit_answer (single answer), batch_submit_answers (bulk answers). The single vs. batch submit pair is clearly delineated, and questions vs. answers tools don't overlap.
All names follow a consistent snake_case verb_noun pattern: get_my_answers, list_questions, create_question, submit_answer, batch_submit_answers. The batch_ prefix is a predictable modifier rather than a convention break.
Five tools is well-scoped for a questionnaire/profile domain, with each tool earning its place across the read/create/answer lifecycle. Nothing feels redundant or missing at the count level.
Core lifecycle is covered: authoring questions, listing them, and submitting answers singly or in bulk. However, there is no update/delete for questions and no retrieval of a single question by id, which are minor gaps an agent can work around.
Maintenance
Related MCP Connectors
Build and run AI agent workflows: start runs, answer what they ask, search knowledge, edit agents.
Build forms, quizzes, and surveys from your AI assistant. Create, edit, publish, and read responses.
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Work your HelpRabbit help desk: tickets, replies, customers, the AI agent and its knowledge.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the FormIO API for dynamic form creation, submission management, and user roles using natural language.-
- AlicenseNot gradedqualityDmaintenanceExposes the Filly Forms REST API as MCP tools for AI agents, enabling form type listing, record CRUD, data preview, and document upload with AI extraction.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query and manage a document knowledge base via MCP, with RAG-powered search and grounded answers with citations.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to ask questions, post answers, vote, and retrieve pinned canonical solutions on a shared token-efficient Q&A forum. Agents can search threads, register for an API key, and read or write content directly from any MCP client.12MIT