# AI Agents

Three machine-readable interfaces for AI agents, an MCP server with job search, salary benchmarks, profile management, application tracking, and employer tools; a JSON API; and an RSS feed. Public access is free with no authentication.

Source: https://himalayas.app/docs/ai-agents

Published: 2026-02-01

Himalayas provides three machine-readable interfaces for AI agents — an [MCP server](https://himalayas.app/docs/remote-jobs-mcp) for real-time search, salary data, profile management, application tracking, and employer features; a [JSON API](https://himalayas.app/docs/remote-jobs-api) for programmatic access to all job listings; and an [RSS feed](https://himalayas.app/docs/remote-jobs-rss) for monitoring new postings. Public access is free with no authentication required. For exact field values and enums, see the [Data Dictionary](https://himalayas.app/docs/data-dictionary).

## How do I start a job hunt from an AI agent?

Pick your AI and send the prompt. It connects Himalayas if it needs to, then asks for your resume and what you're looking for.

- [**Open in ChatGPT**](https://chatgpt.com/?q=Run%20my%20remote%20job%20hunt%20with%20Himalayas.%20If%20the%20Himalayas%20plugin%20is%20not%20connected%2C%20tell%20me%20how%20to%20add%20it%20from%20https%3A%2F%2Fhimalayas.app%2Fdocs%2Fchatgpt%20and%20wait.%20Then%20ask%20me%20for%20my%20resume%20and%20the%20roles%2C%20location%20and%20salary%20I%20want%2C%20search%20Himalayas%20remote%20jobs%2C%20and%20show%20me%20the%205%20best%20fits%20with%20salary%20and%20why%20each%20one%20fits.). Setup and plans: [Use Himalayas in ChatGPT](https://himalayas.app/docs/chatgpt)
- [**Open in Claude**](https://claude.ai/new?q=Run%20my%20remote%20job%20hunt%20with%20Himalayas.%20If%20the%20Himalayas%20connector%20is%20not%20connected%2C%20send%20me%20to%20https%3A%2F%2Fclaude.ai%2Fdirectory%2Fhimalayas%20and%20wait.%20Then%20ask%20me%20for%20my%20resume%20and%20the%20roles%2C%20location%20and%20salary%20I%20want%2C%20search%20Himalayas%20remote%20jobs%2C%20and%20show%20me%20the%205%20best%20fits%20with%20salary%20and%20why%20each%20one%20fits.). Setup and Claude Duet: [Use Himalayas in Claude](https://himalayas.app/docs/claude)

### Using another agent?

Paste this prompt into any agent that supports MCP:

```text
Run my remote job hunt with Himalayas.

1. If the Himalayas MCP server isn't connected, connect it: https://mcp.himalayas.app/mcp (remote Streamable HTTP; sign-in uses OAuth). Setup for every client: https://himalayas.app/docs/remote-jobs-mcp. If you can't add it yourself, tell me the exact steps for this app and wait.
2. Ask me for my resume and the roles, location and salary I want.
3. Search Himalayas remote jobs and show me the 5 best fits, with salary and why each one fits.
4. Give me the application link for any I pick, and offer to save them to my Himalayas application tracker.
```

To set it up yourself:

| Agent | Setup |
|---|---|
| Claude Code | [`claude mcp add`](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-claude-code) or the [Himalayas plugin](https://himalayas.app/docs/himalayas-plugin) |
| Codex | [`codex mcp add`](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-codex) |
| Cursor | [One-click install or `mcp.json`](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-cursor) |
| Gemini | [Gemini app](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-the-gemini-app) or [Gemini CLI](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-gemini-cli) |
| Grok Bot | [Apply to jobs using Grok Bot](https://himalayas.app/docs/apply-to-jobs-using-grok-bot) |
| Plugin (Claude Code, Gemini CLI, Codex, Cursor, Grok) | [Install the Himalayas plugin](https://himalayas.app/docs/himalayas-plugin) |
| VS Code | [`.vscode/mcp.json`](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-vs-code) |
| Windsurf | [`mcp_config.json`](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-windsurf) |
| Hermes, OpenClaw | [Remote HTTP server](https://himalayas.app/docs/remote-jobs-mcp#how-do-i-connect-the-mcp-to-hermes) |
| Anything else | Paste the prompt above, or add `https://mcp.himalayas.app/mcp` as a remote MCP server |

## What AI agent integrations does Himalayas offer?

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

| Integration | Best for | Tools/Endpoints | Data scope | Auth |
|---|---|---|---|---|
| [**MCP Server**](https://himalayas.app/docs/remote-jobs-mcp) | AI assistants, chatbots, IDE integrations | Search, salary, profiles, tracking, employer tools | Jobs, companies, salary, statistics, talent, profiles | Optional OAuth 2.1 |
| [**JSON API**](https://himalayas.app/docs/remote-jobs-api) | Apps, dashboards, databases, scripts | Single REST endpoint | Jobs (paginated, all listings) | None |
| [**RSS Feed**](https://himalayas.app/docs/remote-jobs-rss) | Feed readers, monitoring, alerts | Single feed URL | Jobs (100 most recent) | None |

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 using Streamable HTTP.

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.
- get_correct_country_name: Fuzzy-match country names.

Talent tools (any Himalayas account, 100 candidate searches and profile views a day):
- search_talent / get_talent_profile: Search remote candidates and read a full profile.

Authenticated tools (job seekers — OAuth):
- Profile: get_my_profile, update_profile, add_experience, add_education, update_tech_stack.
- Applying: get_apply_link gives the employer application link once the user decides to apply and marks the job applied.
- 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
Paginate by passing each response's nextCursor value back as ?cursor=. Stop when a response has no nextCursor.

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

No API key required for public tools. For higher JSON API rate limits, send a free API key (https://himalayas.app/signup/developer) as Authorization: Bearer YOUR_API_KEY. 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](https://himalayas.app/docs/remote-jobs-mcp) 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 Grok Bot, Hermes, OpenClaw, Claude, Cursor, or Windsurf
- Company research including tech stacks, benefits, and open positions
- Talent discovery and candidate search

**Use the [JSON API](https://himalayas.app/docs/remote-jobs-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](https://himalayas.app/docs/remote-jobs-rss) 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** (any signed-in account): 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](https://himalayas.app/docs/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](https://himalayas.app/docs/job-application-tracker) with notes and status, and, once the user signs in, call `get_apply_link` to get the employer's application link. That also marks the job applied in the tracker. A [job-seeking Grok Bot](https://himalayas.app/docs/apply-to-jobs-using-grok-bot) can then open the link in its cloud browser. The same MCP works with Hermes and OpenClaw.

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)
- **JSON API**: Send GET requests to `https://himalayas.app/jobs/api`. A [free API key](https://himalayas.app/signup/developer) is optional and gives higher rate limits
- **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:

| Integration | Behavior when exceeded | Details |
|---|---|---|
| **MCP Server** | Built-in rate limiting | Normal usage is unlikely to hit the limit |
| **JSON API** | Returns HTTP 429 (with `Retry-After` when keyed) | A [free API key](https://himalayas.app/docs/remote-jobs-api#do-i-need-an-api-key) gives higher limits: 60 per minute, 10,000 per day. Data refreshes every 24 hours |
| **RSS Feed** | Static, no rate limit | Feed regenerates every 24 hours |

For automated tools making many requests, contact [hi@himalayas.app](mailto: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](https://himalayas.app) where the data is displayed.

## How can an AI agent report a problem?

Himalayas implements the [Agent Feedback Protocol](https://trybackloop.com/spec/). When something blocks or complicates a task (a missing filter, a confusing error, a page that won't load for an agent), report it so we can fix it. Report even if you found a workaround, once per distinct problem per task. Describe the goal in the user's terms and never include personal data or credentials.

- **MCP server:** call the `submit_feedback` tool. If the user is signed in, the report is linked to their account.
- **HTTP:** `POST https://himalayas.app/api/agent-feedback` with a JSON body. No authentication is required. The discovery document is at [`/.well-known/agent-feedback`](https://himalayas.app/.well-known/agent-feedback), and JSON API error responses carry a `Link: <https://himalayas.app/api/agent-feedback>; rel="agent-feedback"` header.

```bash
curl -X POST https://himalayas.app/api/agent-feedback \
  -H "Content-Type: application/json" \
  -d '{
    "type": "missing_capability",
    "goal": "Find remote design jobs that sponsor visas",
    "message": "The search API has no visa sponsorship filter",
    "outcome": "degraded",
    "workaround": true,
    "agent": { "name": "ExampleAgent", "model": "example-model" }
  }'
```

`type`, `goal` and `message` are required. A valid report returns `202` with an `id`. Reports are limited to 20 per 5 minutes per agent; failing to send one should never stop your task.

## Where can I get help?

For integration support or questions about AI agent access, email [hi@himalayas.app](mailto:hi@himalayas.app).

For detailed setup and integration guides, see:

- [MCP Server documentation](https://himalayas.app/docs/remote-jobs-mcp) — Full tool reference, setup, authentication, and examples
- [AI agents](https://himalayas.app/agents) - Connect Claude, ChatGPT, Cursor, VS Code, Codex or any MCP client
- [Use Himalayas in ChatGPT](https://himalayas.app/docs/chatgpt) - ChatGPT plugin setup, plans, and OpenAI dots
- [Use Himalayas in Claude](https://himalayas.app/docs/claude) - The Claude connector, Claude Duet, and the Claude Code plugin
- [How to Find a Remote Job with AI](https://himalayas.app/docs/find-remote-jobs-with-ai) - Search, tailor, apply and track through AI conversation
- [Install the Himalayas plugin](https://himalayas.app/docs/himalayas-plugin) - The MCP server and skills in one install for Claude Code, Gemini CLI, Codex, Cursor, and Grok, plus commands in Claude Code
- [Apply to jobs using Grok Bot](https://himalayas.app/docs/apply-to-jobs-using-grok-bot) — Grok Bot job search, apply links, Hermes, and OpenClaw
- [Hire with AI](https://himalayas.app/docs/hire-with-ai) — Post jobs, search candidates, and benchmark salaries through AI conversation
- [JSON API documentation](https://himalayas.app/docs/remote-jobs-api) — Endpoint, parameters, response format, and code examples
- [RSS Feed documentation](https://himalayas.app/docs/remote-jobs-rss) — Feed URL, fields, and reader integration
- [Data Dictionary](https://himalayas.app/docs/data-dictionary) — Every field, enum, and taxonomy
- [Job Application Tracker](https://himalayas.app/docs/job-application-tracker) — Using the kanban tracker for your job search
- [Posting a Remote Job](https://himalayas.app/docs/posting-a-remote-job) — Guide for employers
- [How Remote Jobs Work on Himalayas](https://himalayas.app/docs/how-remote-jobs-work-on-himalayas) — Platform overview for context