About JobYap
JobYap is a read-only job discovery service aggregating postings from technology companies’ official career sites. It gives AI agents searchable listings with salary and location details, full descriptions, and public discussion threads, without an account or API key.
Key features
- 01Search and filter job listings
- 02Rank jobs against candidate criteria
- 03Retrieve full posting details
- 04Read community discussion threads
- 05Search locations and tracked companies
Use cases
- 01Find remote or local technology roles
- 02Compare jobs by salary and requirements
- 03Generate a shortlist against skills and experience
- 04Review discussion on a job posting
MCP support
Provides a remote streamable HTTP MCP server with tools for searching, matching, and retrieving job postings and related data. A JSON API skill is also available for agents without MCP support.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.jobyap.com/mcpclaude mcp add --transport http jobyap https://mcp.jobyap.com/mcp{"mcpServers":{"jobyap":{"type":"http","url":"https://mcp.jobyap.com/mcp"}}}Open in Cursor{"servers":{"jobyap":{"type":"http","url":"https://mcp.jobyap.com/mcp"}}}Open in VS Code{"mcpServers":{"jobyap":{"type":"http","url":"https://mcp.jobyap.com/mcp"}}}{"mcpServers":{"jobyap":{"serverUrl":"https://mcp.jobyap.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
9| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Substring matched against job titles only. |
| companies | array | No | Exact company names from list_companies. |
| locations | array | No | Location identifiers from search_locations, e.g. city-US-CA-san_francisco. |
| work_mode | enum | No | remote | hybrid |
| posted_within | enum | No | Hard freshness filter on the publish date.24h | 7d | 30d |
| has_comments | boolean | No | Only jobs with community discussion. |
| sort | enum | No | recent (default) or popular (most discussed).recent | popular |
| page_size | integer | No | |
| cursor | string | No | Opaque cursor from a previous next_cursor. |
| include_total | boolean | No | Also compute the total match count (slower). |
Details
From the project READMEJobYap agent tools
Connect any AI agent to JobYap — live job postings aggregated from company career sites, each with salaries, full descriptions and a community discussion thread. Everything is read-only and needs no account or API key.
Two ways in, use either or both:
- MCP server (remote, streamable HTTP):
https://mcp.jobyap.com/mcp - Skill:
skills/jobyapteaches agents the JSON API (https://jobyap.com/api/v1) with curl — works even without MCP support.
Install the MCP server
Claude Code
claude mcp add --transport http jobyap https://mcp.jobyap.com/mcp
Claude.ai / Claude Desktop — Settings → Connectors → Add custom connector →
https://mcp.jobyap.com/mcp (no authentication).
Cursor — click the deeplink, or add the config manually:
{ "mcpServers": { "jobyap": { "url": "https://mcp.jobyap.com/mcp" } } }
VS Code / GitHub Copilot
{ "servers": { "jobyap": { "type": "http", "url": "https://mcp.jobyap.com/mcp" } } }
ChatGPT — Settings → Connectors (developer mode) → Add →
https://mcp.jobyap.com/mcp, No Authentication. The server implements the deep-research
search/fetch contract.
Goose
Windsurf / Zed / JetBrains / LM Studio / others — any streamable-HTTP MCP client
works; point it at https://mcp.jobyap.com/mcp.
stdio-only clients — use the jobyap-mcp
bridge (wraps mcp-remote):
{ "mcpServers": { "jobyap": { "command": "npx", "args": ["-y", "jobyap-mcp"] } } }
Install the skill
Cross-agent (Claude Code, Cursor, Codex, Gemini-compatible CLIs, opencode and ~70 others) via the skills CLI:
npx skills add jobyap/agent-skills
Claude Code plugin — installs the skill and registers the MCP server in one go. Two steps: add the marketplace, then install the plugin:
/plugin marketplace add jobyap/agent-skills
/plugin install jobyap@jobyap
Manual — copy skills/jobyap/ into your agent's skills directory
(.claude/skills/, .cursor/skills/, .agents/skills/, …).
Google Antigravity
The antigravity/jobyap plugin bundles the MCP server config
(serverUrl) and the skill:
git clone https://github.com/jobyap/agent-skills && agy plugin install ./agent-skills/antigravity/jobyap
Or add the MCP server manually with serverUrl: https://mcp.jobyap.com/mcp.
What the tools do
| Tool | Purpose |
|---|---|
search_jobs | Filtered search: title keywords, company, location identifiers, remote/hybrid, freshness, popularity; cursor pagination. |
match_jobs | Candidate matching in one call: title terms, companies, locations, years of experience, sponsorship needs and skills in; a screened, ranked shortlist with requirement sentences out. Reads every description, so a call can take 10 to 15 seconds; use search_jobs for browsing. |
get_job | One posting in full: markdown description, salaries, locations, employment types, apply URL. Accepts ids or jobyap.com URLs. |
get_job_comments | The community discussion thread (threaded, chronological, like counts). |
search_locations | Free text → location filter identifiers. |
list_companies | Tracked companies with active-job counts. |
get_job_stats | Companies tracked, active jobs, newest posting date. |
search / fetch | OpenAI deep-research connector contract over the same data. |
Full API reference: skills/jobyap/references/api.md · Docs: jobyap.com/agents · llms.txt
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.