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)