How do I use HireScript MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@HireScript MCP Server Draft an inclusive job description for a Senior Frontend Engineer" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

HireScript MCP Server

MCP (Model Context Protocol) server for generating inclusive, bias-free job descriptions using Claude AI.

Features

🎯 AI-Powered Generation - Uses Claude to create professional job descriptions
✨ Bias Detection - Analyzes content for gendered, ageist, and ability-biased language
📊 Bias Scoring - Returns a 0-100 inclusivity score
🔧 MCP Compatible - Works with any MCP-enabled client

Installation

npm install
npm run build

Configuration

Set your Anthropic API key:

export ANTHROPIC_API_KEY=your-api-key

Usage

As MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "hirescript": {
      "command": "node",
      "args": ["/path/to/hirescript-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}

Tool: generate_job_description

Generate an inclusive job description with bias analysis.

Parameters:

Name	Type	Required	Description
`job_title`	string	✅	The job title (e.g., "Senior Software Engineer")
`company`	string	❌	Company name for personalization
`requirements`	string	❌	Key requirements, one per line
`benefits`	string	❌	Benefits to highlight
`work_mode`	string	❌	"remote", "hybrid", or "onsite" (default: remote)

Example Request:

{
  "job_title": "Senior Software Engineer",
  "company": "TechCorp",
  "requirements": "5+ years experience\nTypeScript proficiency\nCloud infrastructure knowledge",
  "benefits": "Competitive salary, health insurance, unlimited PTO",
  "work_mode": "hybrid"
}

Example Response:

{
  "jobDescription": "# Senior Software Engineer\n\n## About the Role\n\nWe're looking for a Senior Software Engineer to join our team...",
  "biasScore": 92,
  "biasWarnings": [
    {
      "original": "young and energetic",
      "suggestion": "motivated and dynamic",
      "reason": "Avoid age-related language that may discourage older candidates"
    }
  ]
}

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

How It Works

Takes job details as input
Sends a structured prompt to Claude
Claude generates an inclusive job description
Analyzes the content for potential bias
Returns the description with a bias score and warnings

Bias Detection

The server detects and suggests alternatives for:

Gendered language (he/she → they)
Ageist terms (young, energetic → motivated, dynamic)
Ability-biased language (stand for long periods → specific accommodation notes)
Unnecessary requirements (suggests limiting to truly essential qualifications)
Exclusionary phrases (rockstar, ninja → high performer, expert)