Study MCP Server
Model Context Protocol server providing 12 research tools. Connect it to any MCP-compatible client to access atypica's research capabilities programmatically. The same tools are on the atypica MCP Server, together with interviews and desk research.
Server Endpoint
https://atypica.musedam.cc/mcp/study
Authentication: Bearer token with your API key (atypica_xxx)
Available Tools
| Tool | Description |
|---|---|
| atypica_study_ create | Create a new research session |
| atypica_study_ send_text_message | Send the user's text and run the study agent in the background |
| atypica_study_ submit_tool_result | Give the agent the user's answer to its question or plan |
| atypica_study_ get_messages | What to do next (next), what the study has done (steps), replay link, conversation |
| atypica_study_ get_step | What was said inside one interview, discussion or social observation, live |
| atypica_study_ list | List historical research sessions with replay URLs |
| atypica_study_ get_report | Get research report (HTML) with share URL |
| atypica_study_ get_podcast | Get podcast content and audio with share URL |
| atypica_panel_ search | Search persona panels; pass a panel ID to atypica_study_create |
| atypica_persona_ search | Text search for AI personas |
| atypica_persona_ get | Get detailed persona information |
| atypica_get_ upload_credentials | Get a presigned upload URL for file attachments |
Quick Start
1. Get your API key from account settings
2. Connect to the MCP server with authentication:
curl -X POST https://atypica.musedam.cc/mcp/study \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "atypica_study_create",
"arguments": {
"content": "Research young people's coffee preferences"
}
},
"id": 1
}'Research Workflow
- Create a study with the user's question; keep its
userChatToken. The research agent starts at once and runs in the background - Poll
atypica_study_get_messagesand do what itsnextfield says: wait, answer the agent's question or plan with the user's choice, relay what it said, or fetch the report - Tell the user what the study is doing from
steps, and give themreplayUrlto watch it; after the plan is confirmed a study usually runs half an hour to an hour
atypica-research Skill
The atypica-research skill is a pre-configured agent skill that makes it easy to use atypica's research capabilities with MCP-compatible AI assistants.
Installation Steps
- Get API Key: Visit https://atypica.musedam.cc/account/api-keys to create an API key (format:
atypica_xxx) - Install MCP Server: Add the server to your AI assistant's MCP configuration
# Example command (syntax varies by tool) mcp add --transport http atypica-research https://atypica.musedam.cc/mcp/study \ --header "Authorization: Bearer YOUR_API_KEY_HERE"
- Download Skill: Get the
atypica-researchskill from the download options above - Restart: Restart your AI assistant to load the new skill
Usage Example
Once installed, simply chat with your AI assistant naturally. The skill handles the MCP protocol communication:
User:
"Research young people's coffee preferences and create a report"
AI Assistant:
"I'll create a research study for you. This will involve analyzing consumer data, conducting virtual interviews, and generating a comprehensive report... [proceeds to use atypica tools]"
What the Skill Does
- Creates research sessions automatically
- Manages research workflow and AI execution
- Handles user interactions when confirmation is needed
- Retrieves and presents reports and podcasts with shareable URLs
- Provides AI persona search and selection
Research Types
atypica supports multiple research types, each optimized for different business questions:
Product Testing
A/B testing, user preference comparisons, and feature validation
Market Insights
Consumer behavior analysis, sentiment research, and trend identification
Content Creation
Creative ideation, content strategy, and messaging development
Strategic Planning
Market entry strategies, product roadmaps, and business planning
Product R&D
Innovation discovery, social trend analysis, and product opportunity identification
Fast Insight
Quick research with podcast generation for easy consumption
API Reference
The skill package's reference file is the single source of truth for detailed input/output schemas, states, and workflow for all 12 tools — kept in sync with the server on every release:
atypica-research-skill/references/api-reference.mdSupport & Community
API Keys: Manage your API keys in account settings
Skill Downloads:
Questions? Contact us through our support channels