Overview
atypica.AI provides two integration methods: MCP Server for programmatic access and Agent Skills for direct use in MCP-compatible AI assistants.
Study MCP Server
Model Context Protocol server providing 9 core research tools. Connect it to any MCP-compatible client to access atypica's research capabilities programmatically.
Learn more →atypica-research Skill
Pre-built agent skill ready to use with MCP-compatible AI assistants. Install it once and start conducting research through natural conversations.
Learn more →Study MCP Server
Server Endpoint
https://atypica.ai/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_message | Send message and execute AI synchronously (10-120s) |
| atypica_study_ get_messages | Retrieve conversation history and execution status |
| 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_persona_ search | Semantic search for AI personas |
| atypica_persona_ get | Get detailed persona information |
Quick Start
1. Get your API key from account settings
2. Connect to the MCP server with authentication:
curl -X POST https://atypica.ai/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 research session with initial query
- Send messages to drive research forward (AI executes synchronously)
- Poll for pending interactions that require user input
- Handle interactions by submitting tool results
- Monitor progress and retrieve artifacts (reports/podcasts)
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.
Download Skills: Visit skill0.io to download the atypica-research skill and other community agent skills.
Installation Steps
- Get API Key: Visit https://atypica.ai/account/settings 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.ai/mcp/study \ --header "Authorization: Bearer YOUR_API_KEY_HERE"
- Download Skill: Get the
atypica-researchskill from skill0.io - 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
For complete API documentation including detailed schemas, error handling, and workflow examples, see the skill's built-in reference:
- Detailed input/output schemas for all 9 tools
- Complete workflow examples (basic research, user interactions, etc.)
- Error codes and troubleshooting guide
- Security considerations and limitations
- Performance optimization best practices
Full API documentation is included in the skill download from skill0.io. The skill package contains comprehensive guides and reference materials.
Support & Community
API Keys: Manage your API keys in account settings
Skill Downloads: Get the latest skills from skill0.io
Questions? Contact us through our support channels