Remote Jobs MCP Server

What is the Himalayas MCP server?

The Himalayas MCP server gives AI assistants real-time access to the Himalayas remote jobs marketplace. Search remote jobs with advanced filters, check salary benchmarks, research companies, manage your career profile, track job applications, and even post jobs — all through AI conversation. Connect in any AI platform that supports MCP servers, including Claude (Desktop, Code, Cowork), ChatGPT, Gemini, Cursor, Windsurf, VS Code, Openclaw, and Microsoft Copilot Studio.

Public tools work immediately without any API key or authentication. Authenticated tools for profile management, application tracking, and employer features use OAuth 2.1 with PKCE for secure access.

For complete tool documentation, parameters, and AI agent instructions, see the MCP Server documentation.

What can the MCP server do?

The tools are organized into four categories based on what you need:

Public tools (no authentication required)

• search_jobs: Search remote jobs with filters for keyword, country, experience level, employment type, salary range, currency, benefits, markets, companies, and sort order
• get_jobs: Browse the latest remote job listings with optional country/worldwide filters
• get_job_details: Full job description, requirements, salary, screening questions, and application link
• get_related_jobs: Find similar jobs by skills, location, and category
• search_companies: Search remote companies by keyword, country, benefits, and tech stack
• get_companies: Browse remote-friendly companies
• get_company_details: Comprehensive company profile with tech stack, benefits, and open positions
• get_salary_data: Salary benchmarks by job title, seniority, and country (min/median/max in USD)
• get_remote_work_statistics: Top skills, categories, countries, and industries by job/company count
• search_talent: Search remote candidates by keyword and country
• get_correct_country_name: Fuzzy-match country names for accurate filtering
• check_job_payment_status: Check Stripe payment status for job postings

Job seeker tools (requires free Himalayas account)

• Profile management: get_my_profile, update_profile, add_experience, add_education, update_tech_stack — manage your career profile, work history, education, and technology skills through conversation
• Application tracker: save_job, get_saved_jobs, update_job_status, remove_saved_job — a kanban-style board to track applications through six stages (saved, applied, interviewing, negotiation, hired, archived) with excitement ratings and notes

Employer tools (requires company account)

• Company profile: get_company_profile, update_company_profile, update_company_tech_stack — manage your company's profile, tech stack, and social links
• Perks management: get_company_perks, add_company_perk, remove_company_perk — manage company benefits across 10 categories
• Job management: create_company_job, update_company_job, delete_company_job, list_company_jobs, show_company_job, purchase_job_extras — post jobs with screening questions, view analytics, and purchase promoted placement (sticky $199, newsletter $99)
• Candidate messaging: list_conversations, get_conversation, start_conversation, send_message, mark_conversation_read, delete_conversation — message candidates directly through your AI assistant

Public job posting (no account required)

• post_job_public: Post a remote job without a Himalayas account — provide your email, company details, and job information. Payment via Stripe checkout.

How do I connect the MCP to Claude Desktop?

Go to Settings → Connectors → Add custom connector and paste the server URL:

https://mcp.himalayas.app/mcp

Public tools work immediately. For authenticated tools (profile, tracker, employer features), you'll be prompted to log in on first use.

How do I connect the MCP to Cursor?

Click the button below to automatically install the Himalayas MCP server in Cursor:

Alternatively, add the following to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "himalayas": {
      "url": "https://mcp.himalayas.app/mcp"
    }
  }
}

How do I connect the MCP to Windsurf?

Edit your Windsurf MCP config file at ~/.codeium/windsurf/mcp_config.json and add:

{
  "mcpServers": {
    "himalayas": {
      "serverUrl": "https://mcp.himalayas.app/mcp"
    }
  }
}

Restart Windsurf after saving.

How does authentication work?

Public tools (job search, salary data, company research, market statistics) work without any authentication. For personal and employer tools, the MCP uses OAuth 2.1 with PKCE:

• When you call an authenticated tool, your AI assistant opens a secure login page
• Log in with your Himalayas account (or create one for free)
• Your session is established with automatic token refresh — no re-authentication needed
• Employer tools additionally check that your account is associated with a company

What search filters are available?

The search_jobs tool supports comprehensive filtering:

• keyword:Skills, roles, or technologies (e.g., "python", "product manager")
• country:Full country name (e.g., "United States", "Germany")
• experience: entry-level, mid-level, senior, manager, director, executive
• type: Full Time, Part Time, Contractor, Temporary, Intern, Volunteer
• salary_min / salary_max: Salary range filter with currency support (USD, EUR, GBP, CAD, AUD, and 20+ more)
• benefits: Filter by company benefits offered
• sort: relevant, recent, salaryAsc, salaryDesc

Rate limits and usage

The MCP server includes built-in rate limiting. The limits are generous for typical use — individual users searching for jobs, managing profiles, and posting positions will not hit them. For automated tools making many requests, contact hi@himalayas.app.

Attribution requirements

If you build an application or tool that uses the Himalayas MCP server, include a mention of Himalayas as the data source and link back to himalayas.app where the data is displayed.

Full documentation

For complete tool reference with all parameters, example tool calls, AI agent system instructions, and authentication details, see the MCP Server documentation. Employers looking to post and manage jobs through AI can get started with the Hire with AI guide.

Other ways to access remote job data

Beyond the MCP server, Himalayas offers several integration methods:

• Remote Jobs API: Free public JSON API with a browse endpoint for the full jobs feed and a search endpoint for filtered results. Best for apps, dashboards, and databases.
• RSS Feed: The 100 most recent job postings in XML format. Best for feed readers and monitoring.
• Embeddable Widget: Add live remote job search to any website with one line of code.

For a comparison of all integration methods and guidance on which to use, see the AI Agents documentation.