Using the JobCrawls connector in Claude

The JobCrawls connector lets Claude (and other MCP-compatible AI assistants) search jobs in Finland and read individual listings directly inside a conversation. It is read-only and requires no login.

  • Server URL: https://www.jobcrawls.com/api/connector
  • Transport: Streamable HTTP
  • Authentication: none (public data)
  • Capabilities: read-only

Adding the connector

Until it is listed in the Connectors Directory, you can add it as a custom connector:

  1. Open Claude → Settings → Connectors → Add custom connector.
  2. Enter the server URL: https://www.jobcrawls.com/api/connector.
  3. Leave authentication empty (the connector is authless).
  4. Save. The two tools below become available.

Tool: search_jobs

Searches active job listings in Finland and returns a scoped, paginated list, each with a direct link to the individual posting.

ParameterTypeDescription
querystring (optional)Free-text search across title, description, skills, company, and location.
localeen | fi | sv (optional)Language of listings. Default en.
remoteOnlyboolean (optional)Only fully remote positions.
minSalaryinteger (optional)Minimum salary floor (listing currency, usually EUR).
sortrelevance | date | salary (optional)Result ordering. Default relevance.
limitinteger 1–20 (optional)Results per page. Default 10.
pageinteger ≥1 (optional)Page number. Default 1.

Each result includes: title, company, location, remoteness, job type, salary range (when known), posted date, a short snippet, and a URL deep-linking to the specific posting.

Tool: get_job_details

Returns the full detail for a single listing.

ParameterTypeDescription
jobIdstring (required)The id from a search_jobs result.
companyIdstring (optional)The companyId from the same result; speeds up the lookup.
localeen | fi | sv (optional)Language of the returned content. Default en.

Returns the full description, requirements, responsibilities, benefits, salary, company, location, dates, and a direct link to the posting.

Example prompts

  • “Find software engineering jobs in Helsinki.”
  • “Show me remote data analyst roles in Finland paying at least 4000 a month.”
  • “What are the newest marketing jobs in Finland? Give me 5.”
  • “Tell me more about the second result.”

Privacy

The connector returns only public job data and does not access your conversation history or files. See the connector privacy policy.