# JobYap Job Search (remote · mcp.jobyap.com)

Search job postings aggregated from companies' careers sites, plus each job's discussion thread.

- Trust score: 69/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.jobyap.com`: 69/100 (this document), [markdown](https://verifymcp.io/servers/com-jobyap-jobs/mcp.md), [page](https://verifymcp.io/servers/com-jobyap-jobs/mcp)
- npm · `jobyap-mcp`: 35/100, [markdown](https://verifymcp.io/servers/com-jobyap-jobs/jobyap-mcp.md), [page](https://verifymcp.io/servers/com-jobyap-jobs/jobyap-mcp)

## Channel facts

- Endpoint: `https://mcp.jobyap.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 683 tokens (~85/item across 8 items; 8 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 75% of tool parameters carry a description.
  - Structured output schemas are declared (25% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http com-jobyap-jobs https://mcp.jobyap.com/mcp
```

### Codex

```toml
[mcp_servers.com-jobyap-jobs]
url = "https://mcp.jobyap.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-jobyap-jobs": {
      "type": "remote",
      "url": "https://mcp.jobyap.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-jobyap-jobs --url https://mcp.jobyap.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-jobyap-jobs:
    url: "https://mcp.jobyap.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-jobyap-jobs": {
      "type": "http",
      "url": "https://mcp.jobyap.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +7)

- [security improvement] Authorization: unverified → partial

### 2026-08-02 (score 62, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-01 (score 61)

First indexed and scored.

## MCP tools (8)

### `search_jobs` (~261 tokens)

Search jobs

Search JobYap's aggregated job postings with structured filters. The text query matches job titles only (case-insensitive substring) — try synonyms or shorter tokens when results are thin. Company names must exactly match values from list_companies; locations must be identifiers from search_locations. work_mode matches jobs explicitly marked remote or hybrid (unmarked means unstated, not onsite). Results are active listings, newest first by default; sort=popular ranks by discussion activity. To paginate, pass next_cursor back as cursor and keep every other argument identical.

Input parameters:

- `companies` (array): Exact company names from list_companies.
- `cursor` (string): Opaque cursor from a previous next_cursor.
- `has_comments` (boolean): Only jobs with community discussion.
- `include_total` (boolean): Also compute the total match count (slower).
- `locations` (array): Location identifiers from search_locations, e.g. city-US-CA-san_francisco.
- `page_size` (integer)
- `posted_within` (string): Hard freshness filter on the publish date.
- `query` (string): Substring matched against job titles only.
- `sort` (string): recent (default) or popular (most discussed).
- `work_mode` (string)

### `get_job` (~83 tokens)

Get job details

Fetch one job posting in full: markdown description, salary ranges, locations with work mode, derived employment types, apply URL, posting dates and the canonical JobYap discussion URL. Works for expired jobs too (apply_url is null once inactive).

Input parameters:

- `id` (required): Numeric JobYap job id, a full jobyap.com job URL, or a job page slug.

### `get_job_comments` (~69 tokens)

Get job discussion

Fetch the community discussion thread for a job: chronological, threaded via parent_id, with like counts. Comments are user-generated content. Threads stay open after a job expires.

Input parameters:

- `id` (required): Numeric JobYap job id, a full jobyap.com job URL, or a job page slug.

### `search_locations` (~83 tokens)

Search locations

Resolve a free-text place name ("bay area", "Germany", "berlin") to the location identifiers search_jobs accepts (country-XX, state-XX-YY, city-XX-YY-name). Only places that appear in current job data are returned.

Input parameters:

- `limit` (integer)
- `query` (string, required): Place name fragment, minimum 2 characters.

### `list_companies` (~32 tokens)

List companies

List every company JobYap tracks with its active job count. Use the exact names as search_jobs company filters.

### `get_job_stats` (~25 tokens)

JobYap stats

Aggregate stats: companies tracked, active job count, and the newest posting date.

### `search` (~71 tokens)

Search JobYap (deep research)

Search JobYap job postings by natural-language query. Matches job titles, falling back to significant keywords when the full phrase finds little. Returns result ids, titles and citable URLs for use with fetch. For structured filtering (location, company, remote, freshness) prefer search_jobs.

Input parameters:

- `query` (string, required)

Output parameters:

- `results` (array)

### `fetch` (~59 tokens)

Fetch JobYap document (deep research)

Retrieve the full JobYap document for a search result id: the complete posting as markdown (description, salary, locations, apply link) plus top community comments, with a citable URL.

Input parameters:

- `id` (string, required): A result id returned by search.

Output parameters:

- `id` (string)
- `metadata` (object)
- `text` (string)
- `title` (string)
- `url` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-jobyap-jobs/mcp#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 62
- 2026-08-01: 61

## Links

- Remote endpoint: https://mcp.jobyap.com/mcp
- Repository: https://github.com/jobyap/agent-skills
- Website: https://jobyap.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-jobyap-jobs/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-jobyap-jobs/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-jobyap-jobs/mcp