MCP Server

The McCoy IQ MCP server lets you manage your entire hiring workflow from Claude Code — create roles, generate challenges, publish them, and review responses without leaving your terminal.

Installation

The MCP server is available as an npm package. No global install needed — it runs via npx.

Prerequisites:

Node.js 18 or later
A McCoy IQ account with an API key (see API Keys)
Claude Code (CLI, desktop app, or IDE extension)

Configuration

Add the following to your .mcp.json file (in your project root or ~/.claude/.mcp.json for global access):

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

Replace your-api-key-here with your actual API key.

Usage

Once configured, ask Claude to manage your McCoy IQ account naturally:

Example prompt

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

Example prompt

"Show me all responses for my open challenges."

Example prompt

"Set up my organization branding from our website acme.com."

Claude handles the full workflow automatically — setting up branding, creating roles, generating AI insights, recommending questions, and publishing challenges.

Available tools

Tool	Description
get_organization	Get org profile, logo, and branding
setup_organization	Extract branding from website + upload logo
update_organization	Update org name, website, branding
extract_branding	Extract brand colors and fonts from a website
set_organization_logo	Upload logo from a website URL
list_roles	List all roles
create_role	Create a new role
add_role_source	Upload a job description PDF or text
generate_role_insights	Generate AI insights from role sources
get_challenge_recommendations	Get AI-recommended challenge questions
get_challenge_content	Generate intro script and key highlights
list_challenges	List challenges for a role
create_challenge	Create a new challenge
update_challenge	Update challenge content and branding
publish_challenge	Publish a challenge
list_responses	List candidate responses
get_entitlement	Get plan limits and usage
list_avatars	Browse AI avatars for video intros
generate_avatar_video	Generate an AI avatar video (1 credit)
get_avatar_video_status	Check video generation progress

Environment variables

Variable	Required	Description
MIQ_API_KEY	Yes	Your McCoy IQ API key
MIQ_API_URL	No	API base URL (defaults to production)

npm package

View on npm: npmjs.com/package/mccoy-iq-mcp