JobYap for AI Agents

JobYap's job postings, salaries, full descriptions and community discussions are available to AI agents through two read-only surfaces. No account, API key or authentication is required.

MCP server

A remote Model Context Protocol server (stateless streamable HTTP):

https://mcp.jobyap.com/mcp

Tools: search_jobs, match_jobs, get_job, get_job_comments, search_locations, list_companies, get_job_stats, plus search/fetch implementing the OpenAI deep-research contract.

Use search_jobs to browse, filter, count or page through postings; it answers in under a second. Use match_jobs to find the best postings for one specific person (a resume, or their experience, skills and visa needs): it reads each posting's full description, so a call can take 10 to 15 seconds.

• Claude Code: claude mcp add --transport http jobyap https://mcp.jobyap.com/mcp
• Claude.ai / Desktop: Settings → Connectors → Add custom connector → https://mcp.jobyap.com/mcp
• Cursor: Add to Cursor (one click), or add { "mcpServers": { "jobyap": { "url": "https://mcp.jobyap.com/mcp" } } }
• Windsurf / Zed / others: add { "mcpServers": { "jobyap": { "url": "https://mcp.jobyap.com/mcp" } } }
• VS Code: Install in VS Code (one click), or add { "servers": { "jobyap": { "type": "http", "url": "https://mcp.jobyap.com/mcp" } } }
• ChatGPT: Settings → Connectors (developer mode) → Add → https://mcp.jobyap.com/mcp, No Authentication
• Google Antigravity: MCP config with "serverUrl": "https://mcp.jobyap.com/mcp", or install the plugin from jobyap/agent-skills
• stdio-only clients: npx -y jobyap-mcp (bridges stdio to the hosted endpoint)

JSON API

The same capabilities as plain GET endpoints under https://jobyap.com/api/v1:

• GET /jobs: search by q (title keywords), company, location, work_mode, posted_within and sort, with cursor pagination
• GET /match: shortlist, screen and rank postings for one candidate by titles, companies, locations, candidate_years, needs_sponsorship and skills (10 to 15 seconds per call)
• GET /jobs/{id}: full posting with the description as markdown, salaries, locations and apply URL
• GET /jobs/{id}/comments: the discussion thread
• GET /locations?q=: resolve place names to filter identifiers
• GET /companies: every company on the JobYap Tech Index, with active-job counts and company-page slugs/URLs
• GET /stats: aggregate counts

Example: curl "https://jobyap.com/api/v1/jobs?q=engineer&work_mode=remote&posted_within=7d"

The API is intended for tools and agents rather than search-engine indexing, which is why robots.txt keeps /api/ non-indexable. Responses carry cache headers; please keep page sizes at or below 50 and avoid unbounded bulk requests, as the RSS feed and sitemap exist for bulk discovery.

Agent Skill

The jobyap skill teaches agents when and how to use this API, including the location-identifier grammar, pagination and search semantics:

npx skills add jobyap/agent-skills

Claude Code users can install the skill and the MCP server together as a plugin:

/plugin marketplace add jobyap/agent-skills
/plugin install jobyap@jobyap

Source, plugin manifests and every installer: github.com/jobyap/agent-skills. Machine-readable overview: llms.txt.