JobYap Job Search
Search job postings aggregated from companies' careers sites, plus each job's discussion thread.
| Endpoint | https://mcp.jobyap.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.1.0 |
| Now | 9 tools · grade B (81) · pin ts_71a7f92f1abaa11a15aa92fd86bd13e0 · protocol 2025-06-18 |
| First / last listed | 2026-10-25 00:20 UTC / 2026-10-25 00:20 UTC |
| Grade over time | 2026-10-25: B (81), 9 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_jobs match_jobs get_job get_job_comments search_locations list_companies get_job_stats search fetch
search_jobs | Search JobYap's aggregated job postings with structured filters. Fast (under a second): use it to browse, list, count or page through postings and to answer general questions about who is hiring. To find the best postings for one specific person (a resume, or their experience, skills or visa needs), use match_jobs instead. The text query matches job titles only (case-insensitive substring) — try s params: query, companies, locations, work_mode, posted_within, has_comments, sort, page_size, cursor, include_total |
match_jobs | Find and rank the best live postings for one specific candidate, such as someone who shared a resume or described their experience, skills or visa needs. Slow: it reads each posting's full description, so a call can take 10 to 15 seconds. For browsing, listing or counting postings, use search_jobs, which answers in under a second. Filters active jobs by title terms (any of them; a term matches whe params: titles, exclude_titles, companies, exclude_companies, locations, include_anywhere, work_mode, posted_within, candidate_years, needs_sponsorship, skills, limit |
get_job | 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). params: id* |
get_job_comments | 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. params: id* |
search_locations | Resolve a free-text place name ("toronto", "Japan", "Texas") to the location identifiers search_jobs accepts (country-XX, state-XX-YY, city-XX-YY-name). Searches every place JobYap knows, not only those with current openings, so an identifier may match no jobs. City display omits the state, and the list can be shorter than limit. params: query*, limit |
list_companies | List every company JobYap tracks with its active job count and JobYap company-page URL. Use the exact names as search_jobs company filters. params: none |
get_job_stats | Aggregate stats: companies tracked, active job count, and the newest posting date. params: none |
search | 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. params: query* |
fetch | 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. params: id* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.