The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the JobYap Job Search listing page.
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:
https://mcp.jobyap.com/mcpskills/jobyap teaches agents the JSON API
(https://jobyap.com/api/v1) with curl — works even without MCP support.Claude Code
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:
VS Code / GitHub Copilot
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):
Cross-agent (Claude Code, Cursor, Codex, Gemini-compatible CLIs, opencode and ~70 others) via the skills CLI:
Claude Code plugin — installs the skill and registers the MCP server in one go. Two steps: add the marketplace, then install the plugin:
Manual — copy skills/jobyap/ into your agent's skills directory
(.claude/skills/, .cursor/skills/, .agents/skills/, …).
The antigravity/jobyap plugin bundles the MCP server config
(serverUrl) and the skill:
Or add the MCP server manually with serverUrl: https://mcp.jobyap.com/mcp.
| Tool | Purpose |
|---|---|
search_jobs | Filtered search: title keywords, company, location identifiers, remote/hybrid, freshness, popularity; cursor pagination. |
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