workfinds.app for AI assistants

The MCP server

workfinds.app has a public, read-only Model Context Protocol (MCP) server. AI assistants use it to search the jobs on workfinds.app and link people to them. It is free and needs no account or key.

  • Server URL: https://workfinds.app/mcp
  • Transport: Streamable HTTP (MCP protocol versions 2026-07-28 and 2025-03-26 to 2025-11-25).
  • Authentication: none.
  • Registry name: app.workfinds/jobs

Connect an assistant

Once workfinds.app is listed in an assistant's connector directory, you turn it on there with one click; until then, add it yourself with the steps for your assistant below.

Words in quotes are the assistant's own menu labels as it shows them in English; your assistant shows them in the language of its own settings.

Claude

  1. Open "Customize" > "Connectors".
  2. Click "Add" > "Add custom connector".
  3. Enter a name, for example workfinds, and paste the server URL: https://workfinds.app/mcp
  4. Set "Authentication" to "No sign in".
  5. Click "Add".
  6. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

ChatGPT

  1. On chatgpt.com, open "Plugins".
  2. Click the plus button, then "Add custom MCP server".
  3. Enter a name, for example workfinds, and paste the server URL: https://workfinds.app/mcp
  4. Choose "No authentication".
  5. Click "Create as a plugin", then install the plugin.
  6. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Microsoft Copilot Studio

  1. In your agent, open "Tools".
  2. Click "Add a tool" > "New tool" > "Model Context Protocol".
  3. Enter a name, a short description and the server URL: https://workfinds.app/mcp
  4. Set "Authentication" to "None".
  5. Click "Create" > "Create a new connection" > "Add to agent".
  6. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

GitHub Copilot in VS Code

  1. Run "MCP: Add Server" from the Command Palette.
  2. Choose "HTTP".
  3. Paste the server URL and enter a server ID, for example workfinds: https://workfinds.app/mcp
  4. Or add this under servers in .vscode/mcp.json: "workfinds": {"type": "http", "url": "https://workfinds.app/mcp"}
  5. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Cursor

  1. Open ~/.cursor/mcp.json and add this under mcpServers: "workfinds": {"url": "https://workfinds.app/mcp"}
  2. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Gemini CLI

  1. Run this command: gemini mcp add --transport http workfinds https://workfinds.app/mcp
  2. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Mistral Le Chat

  1. Open "Connectors".
  2. Click "Add Connector" > "Custom MCP Connector".
  3. Enter a name, for example workfinds, and paste the server URL: https://workfinds.app/mcp
  4. Click "Connect".
  5. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

JetBrains AI Assistant

  1. Open "Settings" > "Tools" > "AI Assistant" > "Model Context Protocol (MCP)".
  2. Click "Add".
  3. Choose "Streamable HTTP".
  4. Paste this: {"mcpServers": {"workfinds": {"url": "https://workfinds.app/mcp"}}}
  5. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Cline

  1. Open "MCP Servers" > "Remote Servers".
  2. Enter a name, for example workfinds, and paste the server URL: https://workfinds.app/mcp
  3. Choose "Streamable HTTP".
  4. Click "Add Server".
  5. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

LM Studio

  1. Open "Program" > "Install" > "Edit mcp.json".
  2. Add this under mcpServers: "workfinds": {"url": "https://workfinds.app/mcp"}
  3. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Perplexity

  1. Open "Customize" > "Connectors".
  2. Click "Add custom" > "Add MCP connector" > "Remote".
  3. Enter a name, for example workfinds, and paste the server URL: https://workfinds.app/mcp
  4. Set "Authentication" to "None".
  5. Click "Add".
  6. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Zed

  1. Open "Settings" > "AI" > "MCP Servers".
  2. Click "Add Server" > "Add Remote Server".
  3. Paste the server URL: https://workfinds.app/mcp
  4. Check it works: in a new chat, ask "Find remote data engineer jobs I can apply for from the Philippines, posted this week." If the assistant asks to use a workfinds tool, allow it. The answer lists jobs with links to their pages on workfinds.app.

Any other MCP client: add a remote server with the server URL, the transport Streamable HTTP and no authentication, then check it works as in the last step above.

Tools

Every tool only reads public job and company data, and every job and company in an answer carries its workfinds.app page URL. The tool descriptions below are in English, as the server gives them to assistants.

search_jobs

Search open jobs on workfinds.app. Returns at most 50 jobs per search, in pages of 20 (pages 1 to 3), newest first unless sort is "relevance", each with a workfinds.app page URL, plus the total and a search_url that opens the same search on the site. Every argument is optional; combine them to narrow the search.

  • query: Words to search for: a job title, skill or company name, e.g. "data engineer".
  • country: ISO 3166-1 alpha-2 code of the country the person will work from, e.g. "PH". Returns jobs open to applicants from that country, worldwide remote jobs included. See list_countries.
  • work_arrangement: Any of remote, hybrid, onsite.
  • employment_type: Any of full_time, part_time, contract, temporary, internship.
  • posted_within: Only jobs published within the last 24h, 3d, 7d, 14d or 30d.
  • salary_listed: Only jobs whose employer lists a salary.
  • role: A role family, see list_roles.
  • company_id: Only this company's jobs: the id or page slug from get_company or a job's company.
  • sort: newest (default) or relevance (only with a query).
  • page: Result page, 1 to 3.

get_job

One job by its id or its workfinds.app job URL: title, company, location, work arrangement, employment type, the countries it accepts applicants from, salary when listed, when it was posted, whether it is still open, its apply URL on the employer site and its workfinds.app page. A closed job answers with status "closed" and when it closed.

  • job (required): The job id from search_jobs, or a https://workfinds.app/jobs/... URL.

get_company

One employer by its id or page slug: name, number of open jobs, its workfinds.app page and, when known, its profile (industry, size, headquarters, founded, website, short description). Use search_jobs with company_id for its jobs.

  • company (required): The company id or slug, e.g. a job's company.id.

list_countries

The country codes search_jobs accepts, with their English names.

No arguments.

list_roles

The role families search_jobs accepts as role.

No arguments.

Examples

  • search_jobs with {"query": "data engineer", "country": "PH", "work_arrangement": ["remote"], "posted_within": "7d"}
  • get_job with {"job": "<id from search_jobs>"}
  • search_jobs with {"company_id": "<company.id from a job>", "page": 2}

Rate limits

  • 60 requests a minute from one address, 20 searches a minute, and 500 searches a day (the daily count starts again at 00:00 UTC).
  • A tool over its limit answers with an error saying when to try again; a client over the request limit gets HTTP 429 with Retry-After.
  • Search queries are up to 80 characters; a search returns at most 50 jobs, 20 to a page (pages 1 to 3). Each answer's search_url opens the full search on workfinds.app.

Terms

  • Use of the server is covered by our Terms. Show people the job page link with the jobs you mention.
  • Answers hold no personal data: no accounts, trackers or resumes. Requests are not tied to a person; see the Privacy notice.
  • Listings change and close: tell people to confirm details on the employer site before applying.
  • Questions or problems: support@workfinds.app.