workfinds.app MCP
An official MCP server provided by workfinds.app that allows AI agents to search for open jobs, retrieve specific job details with apply links, list companies, countries, and roles. It aggregates public job listings from company career sites and ATS platforms, enabling users to filter by work arrangement, location, and type without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://workfinds.app/mcpWhat you can do with it
- Search for open jobs using keywords and filters like country or work arrangement
- Retrieve detailed information for a specific job including the apply link
- List available countries and job roles supported by the platform
Source and maintenance
Protocol and capabilities
- Server
- app.workfinds/jobs 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 5 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
search_jobs — 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.
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "Result page, 1 to 3."
},
"role": {
"enum": [
"sales",
"finance-accounting",
"nursing",
"sports-wellness"
],
"type": "string",
"description": "A role family, see list_roles."
},
"sort": {
"enum": [
"newest",
"relevance"
],
"type": "string",
"description": "newest (default) or relevance (only with a query)."
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Words to search for: a job title, skill or company name, e.g. \"data engineer\"."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "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."
},
"company_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,128}$",
"maxLength": 128,
"description": "Only this company's jobs: the id or page slug from get_company or a job's company."
},
"posted_within": {
"enum": [
"24h",
"3d",
"7d",
"14d",
"30d"
],
"type": "string",
"description": "Only jobs published within the last 24h, 3d, 7d, 14d or 30d."
},
"salary_listed": {
"type": "boolean",
"description": "Only jobs whose employer lists a salary."
},
"employment_type": {
"type": "array",
"items": {
"enum": [
"full_time",
"part_time",
"contract",
"temporary",
"internship"
],
"type": "string"
},
"maxItems": 5,
"description": "Any of full_time, part_time, contract, temporary, internship.",
"uniqueItems": true
},
"work_arrangement": {
"type": "array",
"items": {
"enum": [
"remote",
"hybrid",
"onsite"
],
"type": "string"
},
"maxItems": 3,
"description": "Any of remote, hybrid, onsite.",
"uniqueItems": true
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"total",
"total_is_lower_bound",
"page",
"total_pages",
"search_url",
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"company",
"location",
"work_arrangements",
"employment_types",
"eligibility",
"salary",
"posted_at",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string",
"description": "The job page on workfinds.app."
},
"title": {
"type": "string"
},
"salary": {
"type": [
"string",
"null"
],
"description": "As the employer lists it; null when not listed."
},
"company": {
"type": "object",
"required": [
"id",
"name",
"url"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "The company page on workfinds.app."
},
"name": {
"type": [
"string",
"null"
]
}
}
},
"location": {
"type": "string"
},
"posted_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601, when the employer published it."
},
"eligibility": {
"type": "object",
"required": [
"scope",
"countries",
"countries_truncated"
],
"properties": {
"scope": {
"enum": [
"worldwide",
"worldwide_except",
"countries",
"unknown"
],
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"countries_truncated": {
"type": "boolean"
}
},
"description": "Countries people may apply from, as the employer states them."
},
"employment_types": {
"type": "array",
"items": {
"type": "string"
}
},
"work_arrangements": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"page": {
"type": "integer"
},
"total": {
"type": "integer",
"description": "Matching open jobs."
},
"search_url": {
"type": "string",
"description": "The same search on workfinds.app."
},
"total_pages": {
"type": "integer"
},
"total_is_lower_bound": {
"type": "boolean"
}
}
}{
"title": "Search jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_job — Get a 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.
{
"type": "object",
"required": [
"job"
],
"properties": {
"job": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The job id from search_jobs, or a https://workfinds.app/jobs/... URL."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"status",
"id",
"title",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string",
"description": "The job page on workfinds.app."
},
"title": {
"type": "string"
},
"status": {
"enum": [
"open",
"closed"
],
"type": "string"
}
}
}{
"title": "Get a job",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_company — Get a 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.
{
"type": "object",
"required": [
"company"
],
"properties": {
"company": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,128}$",
"maxLength": 128,
"minLength": 1,
"description": "The company id or slug, e.g. a job's company.id."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id",
"name",
"open_job_count",
"url",
"jobs_url",
"profile"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"profile": {
"type": [
"object",
"null"
]
},
"jobs_url": {
"type": "string"
},
"open_job_count": {
"type": "integer"
}
}
}{
"title": "Get a company",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_countries — List countries
The country codes search_jobs accepts, with their English names.
{
"type": "object",
"additionalProperties": false
}{
"type": "object",
"required": [
"countries"
],
"properties": {
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
}{
"title": "List countries",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_roles — List role families
The role families search_jobs accepts as role.
{
"type": "object",
"additionalProperties": false
}{
"type": "object",
"required": [
"roles"
],
"properties": {
"roles": {
"type": "array",
"items": {
"type": "object",
"required": [
"role",
"name"
],
"properties": {
"name": {
"type": "string"
},
"role": {
"type": "string"
}
}
}
}
}
}{
"title": "List role families",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1431 ms
- 95th percentile latency
- 1431 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1431 ms · metadata changed · 5 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http workfinds-app-mcp https://workfinds.app/mcpCodex
codex mcp add workfinds-app-mcp --url https://workfinds.app/mcpCursor
{
"mcpServers": {
"workfinds-app-mcp": {
"url": "https://workfinds.app/mcp"
}
}
}Cline
{
"mcpServers": {
"workfinds-app-mcp": {
"type": "streamableHttp",
"url": "https://workfinds.app/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"workfinds-app-mcp": {
"type": "http",
"url": "https://workfinds.app/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http workfinds-app-mcp https://workfinds.app/mcpClaude Desktop
{
"mcpServers": {
"workfinds-app-mcp": {
"url": "https://workfinds.app/mcp"
}
}
}Windsurf
{
"mcpServers": {
"workfinds-app-mcp": {
"serverUrl": "https://workfinds.app/mcp"
}
}
}Let your agent find its tools
Find servers like workfinds.app MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run workfinds.app MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.