Back to Directory/Search & Knowledge

JobYap Job Search

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

Search & KnowledgeJavaScriptv1.1.0

JobYap 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/jobyap teaches 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:

Add to Cursor

{ "mcpServers": { "jobyap": { "url": "https://mcp.jobyap.com/mcp" } } }

VS Code / GitHub Copilot

Install in VS Code

{ "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

Add to 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

ToolPurpose
search_jobsFiltered search: title keywords, company, location identifiers, remote/hybrid, freshness, popularity; cursor pagination.
get_jobOne posting in full: markdown description, salaries, locations, employment types, apply URL. Accepts ids or jobyap.com URLs.
get_job_commentsThe community discussion thread (threaded, chronological, like counts).
search_locationsFree text → location filter identifiers.
list_companiesTracked companies with active-job counts.
get_job_statsCompanies tracked, active jobs, newest posting date.
search / fetchOpenAI deep-research connector contract over the same data.

Full API reference: skills/jobyap/references/api.md · Docs: jobyap.com/agents · llms.txt

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y jobyap-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "com-jobyap-jobs": {
      "command": "npx",
      "args": [
        "-y",
        "jobyap-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

jobyap-mcpnpm

Compatible MCP Clients

JobYap Job Search works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More