{
  "markdown": "# Remoet MCP server\n\nConnect your AI agent to [Remoet](https://remoet.dev), the job platform built for agents. Search the public job catalogue, find tech companies by the stack they actually build on, star the ones you'd work for so their new jobs land in your feed, and manage your developer profile, all through conversation.\n\nThis repo ships a **local stdio MCP server** (Node + TypeScript) plus the metadata MCP clients and directory registries need. The local server advertises Remoet's full tool catalog (snapshotted from the live server) and forwards calls to the hosted MCP at `https://api.remoet.dev/mcp` with your Bearer key. The hosted server is closed source and remains the source of truth for execution.\n\nMost users connect to the hosted server directly (see [Quick install](#quick-install) below). The local package is for clients that prefer stdio or build/scan systems that require a runnable local server.\n\n- **Homepage:** https://remoet.dev\n- **Docs:** https://docs.remoet.dev\n- **MCP endpoint:** `https://api.remoet.dev/mcp`\n- **Get a free API key:** https://remoet.dev/onboarding\n\n## What it does\n\nThe job catalogue is public. `search_jobs` reads every role on the open board at [remoet.dev/jobs](https://remoet.dev/jobs), across all companies, before you star anything.\n\nA star is about delivery, not access. Remoet derives each company's tech stack from the roles it is hiring for right now, not from self-reported adoption lists that go stale, so an agent can match you to companies by the technologies they actually build on today. Star the ones that fit and their new jobs land in your feed, with the company's full stack unlocked. Remoet also keeps your profile, saved jobs, applications and weekly digests on file, all over MCP.\n\nRemoet is free for job seekers. There are no paid plans and no credit card. One set of limits applies to every account, and `get_account` reports where you stand against them.\n\nSee [`tools.md`](./tools.md) for the full tool catalog.\n\n## Works with\n\nClaude Code, Claude Desktop, Claude Web, Cursor, VS Code, Windsurf, Codex, and any MCP-compatible client. Also installable as an [agentskills.io](https://agentskills.io) skill on OpenClaw (via ClawHub) and Hermes Agent. See [Quick install](#quick-install).\n\n## Auth\n\nTwo transports, same tools:\n\n- `https://api.remoet.dev/mcp` expects an API key as a Bearer header (`Authorization: Bearer <key>`). Best for CLI and always-on agents.\n- `https://api.remoet.dev/mcp/oauth` runs OAuth 2.1 with PKCE and dynamic client registration. Best for browser clients like Claude Web and Desktop custom connectors.\n\nGenerate a key at [remoet.dev/onboarding](https://remoet.dev/onboarding). The same key works for MCP and the REST API.\n\n## Quick install\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http --scope user remoet https://api.remoet.dev/mcp --header \"Authorization: Bearer YOUR_KEY\"\n```\n\nThen restart Claude Code (exit and relaunch) so the new server's tools load in a fresh session.\n\n### Cursor, VS Code, Windsurf\n\nAdd to your client's MCP config (the JSON in [`.mcp.json`](./.mcp.json) works as a template):\n\n```json\n{\n  \"mcpServers\": {\n    \"remoet\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.remoet.dev/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_KEY\" }\n    }\n  }\n}\n```\n\n### Claude Web / Desktop (custom connector)\n\nAdd a custom connector pointing at `https://api.remoet.dev/mcp/oauth` and complete the browser sign-in. No API key to paste.\n\nRemoet also ships as an [agentskills.io](https://agentskills.io) skill, with one-command installs on Hermes and OpenClaw.\n\n### Hermes\n\n```bash\nhermes skills tap add remoet-labs/agent-skills\nhermes skills install remoet-labs/agent-skills/skills/remoet\n```\n\n### OpenClaw\n\n```bash\nopenclaw skills install remoet\n```\n\n## First prompt to try\n\n> I work in Rails, React, and Postgres. Which companies on Remoet hire for that stack?\n\n## Run locally (Node + Docker)\n\nIf you prefer a local stdio MCP server (or a build/scan system needs one), the same package is runnable directly.\n\n**With Node:**\n\n```bash\nnpm install\nnpm run build\nREMOET_API_KEY=\"<your-key>\" node dist/index.js\n```\n\nThe server speaks MCP over stdio. Set `REMOET_API_KEY` to a free-tier key from [remoet.dev/onboarding](https://remoet.dev/onboarding). Optionally override the upstream endpoint with `REMOET_MCP_URL` (defaults to `https://api.remoet.dev/mcp`).\n\n**With Docker:**\n\n```bash\ndocker build -t remoet-mcp .\ndocker run --rm -i -e REMOET_API_KEY=\"<your-key>\" remoet-mcp\n```\n\nThe container's entrypoint runs the stdio server. Pipe MCP JSON-RPC frames into the container; tool calls are forwarded to the hosted server with your Bearer key.\n\nThe published tool catalog lives in [`data/tools.json`](./data/tools.json), generated from the live `tools/list`. Refresh it whenever the hosted server's tool surface changes:\n\n```bash\nREMOET_API_KEY=\"<your-key>\" npm run snapshot:tools\n```\n\nThe script rewrites the snapshot and reports any tool that [`tools.md`](./tools.md) has fallen out of step with.\n\n## License\n\n[MIT](./LICENSE). The wrapper is open; the Remoet backend it points at is a hosted service.\n",
  "bytes": 5136,
  "sha": "5449aa90e7d7884b1bab5ab9917269ebf3353ab811fa23ed5d0c86479a8c4b03",
  "repo_slug": "remoet-labs/remoet-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_remoet_labs_remoet_mcp_84433843/readme"
}