Study MCP Server

Model Context Protocol server providing 10 core research tools. Connect it to any MCP-compatible client to access atypica's research capabilities programmatically.

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 a message; the study agent runs asynchronously in the background
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_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.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 asynchronously in the background)
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 Options

atypica-ai/atypica-research-skill

Direct download • Source code • Issues & contributions

🎯

skill0.io

Community skills • Browse catalog • Easy install

Installation Steps

Get API Key: Visit https://atypica.ai/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.ai/mcp/study \
  --header "Authorization: Bearer YOUR_API_KEY_HERE"

Download Skill: Get the atypica-research skill 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, error codes, and workflow examples for all 10 tools — kept in sync with the server on every release:

atypica-research-skill/references/api-reference.md

Support & Community

API Keys: Manage your API keys in account settings

Skill Downloads:

atypica-ai/atypica-research-skill 🎯 skill0.io

Questions? Contact us through our support channels

atypica.AI Docs