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

Even though Claude Desktop doesn't yet support remote MCP clients directly, you can use the mcp-remote local proxy to connect it to the Himalayas MCP server. This lets you test what an interaction with our remote MCP server will be like with a real-world MCP client.

Open Claude Desktop and navigate to Settings → Developer → Edit Config. This opens the configuration file that controls which MCP servers Claude can access.

Replace the content with a configuration like this:

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

Save the file and restart Claude Desktop (command/ctrl + R). When Claude restarts, a browser window will open showing the OAuth login page. Complete the authorization flow to grant Claude access to the Himalayas MCP server.

Once authenticated, you'll be able to see the job search tools by clicking the tools icon in the bottom right corner of 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://himalayas.app/mcp/sse

Connect to Windsurf

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

{
  "mcpServers": {
    "himalayas": {
      "command": "npx",
      "args": ["mcp-remote", "https://himalayas.app/mcp/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.