MCP Server

The Model Context Protocol (MCP) lets AI assistants connect directly to HiringTrends data. Instead of copy-pasting numbers, your AI tool queries our API on your behalf and weaves the results into its responses.

Supported Clients

• Claude Desktop
• Cursor
• Codex (OpenAI)
• Gemini CLI

See /mcp for client-specific setup instructions and configuration snippets.

OAuth Connection Flow

When you first connect, your AI client will redirect you to HiringTrends to authorize the connection. After approving, the client receives an access token and can make requests on your behalf. Tokens expire after 30 days and can be revoked at any time from the /mcp page.

Available Tools

• stack_trends — trending tech stacks with week-over-week demand changes. Parameters: window (1w / 4w / 12w).
• company_velocity — companies ranked by hiring velocity. Parameters: limit (1–100).
• salary_percentiles — salary breakdown (p25/p50/p75/p90) by stack or role. Parameters: stack, role.
• job_search — search job postings. Parameters: q, location, limit.
• skill_demand — skills most in-demand with weekly demand trends. Parameters: window.
• skill_cooccurrence — skills that commonly pair with specified technologies. Parameters: skills (1–5), limit.
• market_news — weekly market news with volume changes, salary trends, emerging and declining skills. Parameters: window.
• weekly_digest — comprehensive weekly summary with total jobs, top stacks, skills, and trends. Parameters: window.
• remote_work_trends — remote vs hybrid vs onsite percentages over time. Parameters: window.
• hiring_velocity — weekly job posting volume with week-over-week changes. Parameters: stack, window.
• company_profile — detailed company profile including roles, skills, salary, and remote rate. Parameters: company (required).
• job_quality — top quality postings ranked by detail richness. Parameters: remote, min_salary.
• experience_requirements — experience level distribution with job counts and salary. Parameters: role.
• certification_demand — in-demand certifications with required vs preferred counts. Parameters: role, limit.
• culture_benefits — workplace culture signals, benefits, and perks. Parameters: category.
• geographic_data — salary and hiring data by location. Parameters: locations.
• role_health — role health scores with demand, salary growth, and remote availability. Parameters: roles.
• salary_by_industry — salary percentiles by industry. Parameters: industry, experience_level.
• education_requirements — education requirement percentages by role. Parameters: role.
• employment_types — hiring by employment type (full-time, contract, etc.). Parameters: role, window.

Quotas

MCP requests share the same quota as the REST API:

Setup

Visit the MCP setup page to configure your client and manage connected sessions.