mccoy-iq-mcp

MCP server for McCoy IQ — create roles, generate AI-powered video challenges, publish them, and review candidate responses, all from Claude Code.

Setup

1. Get your API key

Log in to iq.mccoy.io, go to Settings > API Keys, and create a new key.

2. Add to Claude Code

Add this to your .mcp.json (project-level or ~/.claude/.mcp.json for global):

{
  "mcpServers": {
    "mccoy-iq": {
      "command": "npx",
      "args": ["-y", "mccoy-iq-mcp"],
      "env": {
        "MIQ_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Start using it

Ask Claude to create a challenge:

"Create a Senior Frontend Engineer role for my company, generate challenge questions, and publish the best one."

Claude will handle the full workflow: set up branding, create the role, generate AI insights, recommend questions, create the challenge, and publish it.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MIQ_API_KEY | Yes | — | Your McCoy IQ API key | | MIQ_API_URL | No | https://api.mccoyapp.com | API base URL (use https://api-staging.mccoyapp.com for staging) |

Tools

| Tool | Description | |------|-------------| | get_organization | Get org profile, logo, website, and branding | | update_organization | Update org name, website, LinkedIn, brand colors/fonts | | setup_organization | One-shot: extract branding from website + upload logo | | extract_branding | Extract brand colors and fonts from a company website | | set_organization_logo | Fetch and upload a logo from a website URL | | list_roles | List all roles for the organization | | create_role | Create a new role with title, description, skills | | add_role_source | Upload a job description PDF or text as a role source | | generate_role_insights | Generate AI insights from role sources (blocking) | | get_challenge_recommendations | Get AI-recommended challenge questions for a role | | get_challenge_content | Generate intro script and key highlights for a challenge | | list_challenges | List challenges for a role | | create_challenge | Create a new challenge with a question | | update_challenge | Update challenge content and branding | | publish_challenge | Publish a challenge to make it live | | list_responses | List candidate video responses for a challenge | | get_entitlement | Get plan limits and usage (AI avatar credits) | | list_avatars | Browse available AI avatars for video intros | | generate_avatar_video | Generate an AI avatar video intro (uses 1 credit) | | get_avatar_video_status | Check avatar video generation progress |

Typical Workflow

get_organization          → check org profile & branding
  ↓
setup_organization        → extract brand colors, upload logo
  ↓
create_role               → create a role (e.g. "Senior Engineer")
  ↓
add_role_source           → upload job description PDF or text
  ↓
generate_role_insights    → AI analyzes the role (blocking)
  ↓
get_challenge_recommendations → get AI-recommended questions
  ↓
create_challenge          → create challenge with chosen question
  ↓
get_challenge_content     → generate intro script + highlights
  ↓
update_challenge          → apply content + branding
  ↓
publish_challenge         → make it live
  ↓
generate_avatar_video     → (optional) create AI avatar intro

License

MIT