Remote Jobs Model Context Protocol

What is the Model Context Protocol (MCP)?

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. Our Himalayas MCP server provides AI models with direct access to our remote job and company database through standardized tools.

Getting started with the Himalayas MCP

Our MCP server allows AI assistants to search and retrieve remote job listings and company information from Himalayas in real-time. This enables more accurate and up-to-date responses when users ask about remote work opportunities.

Available MCP tools

Our MCP server provides two main tools for accessing remote job data:

1. search_jobs

Search and filter remote job listings with the following parameters:

• keyword (optional): Search term to find jobs matching specific skills, roles, or technologies
• page (optional, default: 1): Page number for pagination through results
• country (optional): Filter jobs by specific country (e.g., 'Canada', 'United States', 'UK')
• worldwide (optional): Show only 100% remote jobs available worldwide (overrides country filter)

2. search_companies

Search and filter companies offering remote positions:

• keyword (optional): Search term to find companies by name, industry, or description
• page (optional, default: 1): Page number for pagination through results
• country (optional): Filter companies by specific country (e.g., 'Canada', 'United States', 'UK')
• worldwide (optional): Show only companies with 100% remote jobs available worldwide (overrides country filter)

Installation and setup

To use the Himalayas MCP server, you'll need to install it in your MCP-compatible AI assistant or application. The server connects directly to our live database to provide real-time job and company information.

Connect to Claude Desktop

To connect the Himalayas MCP server to Claude Desktop, you'll need to edit your Claude Desktop configuration file.

macOS/Linux Setup

Open the Claude Desktop configuration file located at:

~/Library/Application Support/Claude/claude_desktop_config.json

If this file doesn't exist, create it. Then add the Himalayas MCP server configuration:

{
  "mcpServers": {
    "himalayas": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.himalayas.app/sse"]
    }
  }
}

Windows Setup

On Windows, the configuration file is located at:

%APPDATA%\\Claude\\claude_desktop_config.json

Use the same JSON configuration as shown above.

Prerequisites

Make sure you have Node.js installed on your system. You can verify this by running node --version in your terminal.

Activation

After saving the configuration file, completely restart Claude Desktop. The Himalayas MCP server will automatically connect and be available for use.

Once connected, you'll see the Himalayas job search tools available via the attachment/tools icon in Claude's interface.

Connect to Cursor

To connect Cursor with the Himalayas MCP server, choose Type: "Command" and in the Command field, enter:

npx mcp-remote https://mcp.himalayas.app/sse

Connect to Windsurf

You can connect the Himalayas MCP server to Windsurf by editing the mcp_config.json file and adding the following configuration:

{
  "mcpServers": {
    "himalayas": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.himalayas.app/sse"]
    }
  }
}

Data fields returned

When searching jobs, the MCP returns comprehensive job information including:

• title: Job title
• excerpt: Brief job description
• companyName: Hiring company name
• companyLogo: Company logo URL
• employmentType: Full Time, Part Time, Contractor, Temporary, Intern, Volunteer, or Other
• locationRestrictions: Required candidate locations (if any)
• timezoneRestriction: Required time zones (if any)
• category: Job categories and skills
• description: Full job description
• pubDate: Publication date
• applicationLink: Direct application URL
• guid: Unique job identifier

Rate limits and usage

Our MCP server includes built-in rate limiting to ensure reliable service for all users. The server is designed to handle real-time queries efficiently while maintaining data freshness and accuracy.

Attribution requirements

When using our MCP server, please ensure that any job listings or company information displayed to users includes proper attribution to Himalayas as the original source. This helps support our platform and ensures users can access the most up-to-date information directly.

Support and documentation

For technical support, implementation questions, or to request additional MCP tools and features, please contact our development team. We're committed to making remote job data easily accessible through modern AI interfaces.

Other ways to access our data

In addition to our MCP server, we also provide other methods to access Himalayas job data:

• JSON API: Access our complete job database programmatically with our REST API
• RSS feed: Subscribe to the latest remote job postings with our RSS feed

These alternatives are useful for different integration scenarios, whether you need direct API access for web applications or RSS feeds for content aggregation.