RemoteOK Scout MCP

Standard job-search MCP for remoteok.com.

Wraps this board’s public API/RSS into a standard MCP (search_jobs / get_job) so any Agent Host can use it — not only Zhencheng Nest. Works with any MCP Host (Cursor, Claude Desktop / Code, Codex, Zhencheng Agent, …).

Publish status: Protocol + docs + standalone runner bundle — no Zhencheng monorepo required at runtime.

Quick start

cd zc-scout-channels
npm i
cd remoteok
node stdio_mcp_server.mjs

Related MCP server: We Work Remotely Scout MCP

Host config

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "zc-remoteok-scout-mcp": {
      "command": "node",
      "args": ["/ABS/PATH/zc-scout-channels/remoteok/stdio_mcp_server.mjs"]
    }
  }
}

Claude Desktop

Same shape under mcpServers in Claude Desktop config.

Zhencheng Agent

Add to external MCP allowlist as stdio:

{
  "id": "remoteok-official",
  "name": "RemoteOK 搜岗",
  "transport": "stdio",
  "command": "node",
  "args": ["/ABS/PATH/zc-scout-channels/remoteok/stdio_mcp_server.mjs"]
}

Tools

search_jobs

get_job

Result shape

{
  "title": "...",
  "company": "...",
  "location": "...",
  "applyUrl": "https://...",
  "sourceUrl": "https://...",
  "publishedAt": "2026-09-01",
  "snippet": "...",
  "salary": null,
  "remote": true,
  "source": "remoteok-official"
}

Limits

• Read-only; no apply proxy; no site cookies in the package

• Polite rate limit ≥800ms between tool calls

• Soft location filter when the site has no geo API

• Respect robots/ToS of remoteok.com

Skill

See skills/zc-remoteok-scout/SKILL.md — host-neutral; points at real MCP tools search_jobs / get_job.

License

MIT — see LICENSE.