AI Agents

Himalayas provides three machine-readable interfaces for AI agents — an MCP server for real-time search, salary data, profile management, application tracking, and employer features; a JSON API for programmatic access to all job listings; and an RSS feed for monitoring new postings. Public access is free with no authentication required. For exact field values and enums, see the Data Dictionary.

What AI agent integrations does Himalayas offer?

Himalayas offers three ways for AI agents, LLMs, and automated tools to access remote job data:

All three integrations are completely free to use for public data. The MCP server additionally offers authenticated tools for personal and employer features through OAuth 2.1 with PKCE.

What can the MCP server do that the API and RSS cannot?

The MCP server is significantly more powerful than the JSON API or RSS feed. Beyond basic job search, it provides:

• Salary benchmarks by job title, seniority, and country (min/median/max in USD)
• Remote work market statistics — top skills, categories, countries, and industries by job/company count
• Full company profiles with tech stacks, benefits, founding details, and open positions
• Talent search across remote candidates
• Profile management — update your career profile, work experience, education, and tech stack through conversation
• Job application tracker — a kanban-style board to save, track, and manage job applications through six pipeline stages
• Employer tools — post jobs, manage company profiles, add perks, purchase promoted placement, all via AI conversation
• Related job discovery — find similar jobs based on skills, location, and category
• Advanced search filters — experience level, employment type, salary range, currency, benefits, markets, and more

The JSON API and RSS feed provide job listing data only, without search filters, salary data, company profiles, or authenticated features.

System instructions for AI agents

If you are building an AI agent or configuring an LLM to use Himalayas, include the following in your system prompt:

You have access to Himalayas, a remote jobs marketplace with over 100,000 job listings, company profiles, salary data, and career tools.

MCP Server (real-time):
Connect to https://mcp.himalayas.app/mcp (Streamable HTTP) or https://mcp.himalayas.app/sse (SSE fallback).

Public tools (no auth):
- search_jobs: Search remote jobs with filters for keyword, country, experience, type, salary range, currency, benefits, markets, companies, sort order.
- get_jobs / get_companies: Browse latest listings.
- search_companies: Search companies by keyword, country, benefits, tech stack.
- get_job_details / get_company_details: Full profiles by slug.
- get_related_jobs: Similar jobs by skills, location, category.
- get_salary_data: Salary benchmarks by role, seniority, country (min/median/max USD).
- get_remote_work_statistics: Top skills, categories, countries, industries by count.
- search_talent: Search remote candidates.
- get_correct_country_name: Fuzzy-match country names.

Authenticated tools (job seekers — OAuth):
- Profile: get_my_profile, update_profile, add_experience, add_education, update_tech_stack.
- Tracker: save_job, get_saved_jobs, update_job_status, remove_saved_job.

Authenticated tools (employers — OAuth + company account):
- Company: get_company_profile, update_company_profile, update_company_tech_stack.
- Perks: get_company_perks, add_company_perk, remove_company_perk.
- Jobs: create_company_job, update_company_job, delete_company_job, list_company_jobs, show_company_job, purchase_job_extras.

JSON API (all jobs, paginated):
GET https://himalayas.app/jobs/api?limit=20&offset=0

RSS Feed (100 most recent):
https://himalayas.app/jobs/rss

No API key required for public tools. For field values (employment types, seniority levels, currencies), see: https://himalayas.app/docs/data-dictionary

Which integration should I use?

Choose based on your use case:

Use the MCP Server if you need:

• Conversational job search with advanced filters (salary, experience, type, benefits)
• Salary benchmarks and market statistics
• Profile management and career tools through AI conversation
• Job application tracking with a kanban-style pipeline
• Employer features: job posting, company management, perks
• Real-time results within AI assistants like Claude, Cursor, or Windsurf
• Company research including tech stacks, benefits, and open positions
• Talent discovery and candidate search

Use the JSON API if you need:

• Programmatic access to all job listings
• Pagination through the full database
• Integration into apps, dashboards, or databases
• A standard REST endpoint with JSON responses

Use the RSS Feed if you need:

• The 100 most recent job postings
• Feed reader or content aggregator integration
• Simple monitoring without code
• XML format for RSS-compatible tools

What data can AI agents access?

Through the MCP server, agents can access:

• Job listings: Title, company, salary range, location restrictions, timezone restrictions, categories, full description, screening questions, and application link
• Company profiles: Name, industry, employee count, founding year, tech stack, benefits, open positions, social links
• Salary benchmarks: Minimum, median, and maximum salary by job title, seniority level, and country (in USD)
• Market statistics: Top skills, job categories, countries, and industries ranked by remote job or company count
• Talent profiles: Candidate name, current role, salary expectations, search status, location
• User profiles (authenticated): Career preferences, work experience, education, tech stack
• Application tracker (authenticated): Saved jobs with pipeline status, notes, and excitement ratings
• Employer data (authenticated): Company profile management, perks, job postings with analytics

Through the JSON API and RSS feed, agents can access job listing data only.

For complete field definitions, valid enum values, and data formats, see the Data Dictionary.

Can AI agents apply to jobs on behalf of users?

Not directly yet. AI agents can search for and filter jobs, save them to the application tracker with notes and status, and provide the applicationLink so users can apply.

Auto-apply capabilities are on the Himalayas roadmap and will allow AI agents to submit applications with a resume and cover letter on the user's behalf.

Do I need an API key?

No. All three Himalayas integrations are completely free for public data and require no API key:

• MCP Server: Connect directly to https://mcp.himalayas.app/mcp (Streamable HTTP) or https://mcp.himalayas.app/sse (SSE)
• JSON API: Send GET requests to https://himalayas.app/jobs/api
• RSS Feed: Subscribe to https://himalayas.app/jobs/rss

For MCP authenticated features (profile, tracker, employer tools), users connect their Himalayas account through a secure OAuth 2.1 flow — still no API key needed.

What are the rate limits?

Each integration has built-in rate limiting to ensure fair usage:

For automated tools making many requests, contact hi@himalayas.app to discuss your use case.

What are the attribution requirements?

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

Where can I get help?

For integration support or questions about AI agent access, email hi@himalayas.app.

For detailed setup and integration guides, see:

• MCP Server documentation — Full tool reference, setup, authentication, and examples
• Hire with AI — Post jobs, search candidates, and benchmark salaries through AI conversation
• JSON API documentation — Endpoint, parameters, response format, and code examples
• RSS Feed documentation — Feed URL, fields, and reader integration
• Data Dictionary — Every field, enum, and taxonomy
• Job Application Tracker — Using the kanban tracker for your job search
• Posting a Remote Job — Guide for employers
• How Remote Jobs Work on Himalayas — Platform overview for context