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

ToolDescription
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

  1. Create research session with initial query
  2. Send messages to drive research forward (AI executes synchronously)
  3. Poll for pending interactions that require user input
  4. Handle interactions by submitting tool results
  5. 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

  1. Get API Key: Visit https://atypica.ai/account/settings to create an API key (format: atypica_xxx)
  2. 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"
  3. Download Skill: Get the atypica-research skill from skill0.io
  4. 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

MCP & Skills Documentation | atypica.AI