Job alerts, saved jobs and deadline reminders on your phone

Open app

Connect JobCrawls to your AI assistant

JobCrawls works inside ChatGPT, Claude and other AI assistants that support the Model Context Protocol (MCP). Your assistant can search open jobs in Finland, read a listing in full and work out Finnish take-home pay, right in the conversation. There are two ways to connect.

JobCrawls is not affiliated with or endorsed by Anthropic or OpenAI.

Public connectorAccount connector
AccountNone neededYour JobCrawls account
Server URLhttps://www.jobcrawls.com/api/connectorhttps://www.jobcrawls.com/api/mcp/seeker
Tools4 read-only tools over public data (listed below)The same tools, plus your profile, CV, tracked jobs, watchlist, alerts and the writing tools
Limits60 tool calls an hour per address, in bursts of up to 10. Calls ChatGPT and Claude relay from their published addresses get 3,000 an hour per relaying address, since one of their addresses carries many people's calls.A weekly allowance of tool calls. Every signed-in user gets every tool; paid plans only raise the limits.
Personal dataNone. The tools take no personal data and store nothing.Only your own, and only what you ask your assistant to read or change

Looking for prompts that work and a walk-through for job seekers? See Find jobs in Finland with ChatGPT or Claude.

Set up the public connector

No account, no key. Add the server URL as a custom connector in your assistant.

ChatGPT

  1. Open Settings, then Apps and connectors, and enable Developer mode under Advanced settings.
  2. Choose Create, paste https://www.jobcrawls.com/api/connector as the server URL and set authentication to None.
  3. Start a new chat and ask, for example, "Find remote software developer jobs in Finland".

Claude (web and desktop)

  1. Open Claude → Settings → Connectors → Add custom connector.
  2. Enter the server URL: https://www.jobcrawls.com/api/connector. Leave authentication empty.
  3. Save. The tools are available in new conversations.

Claude Code

claude mcp add --transport http jobcrawls https://www.jobcrawls.com/api/connector

Other MCP clients

Any client that speaks Streamable HTTP connects with the URL alone, for example { "type": "url", "url": "https://www.jobcrawls.com/api/connector" }. No headers or tokens are needed. Clients that do not render MCP Apps still get the full result as text.

Set up the account connector

The account connector knows who you are, so your assistant can save jobs, move them through your tracker, follow companies, set alerts, read your profile and CV, and draft a tailored CV or cover letter. Your assistant asks you before every change it makes.

  1. Sign in to JobCrawls and open AI assistants in your account. It shows the steps for Claude, ChatGPT, Claude Code and other assistants, and creates the personal key the connection uses.
  2. Add https://www.jobcrawls.com/api/mcp/seeker as a custom connector in your assistant with that key, as the page describes.
  3. Remove the public connector if you added it: the account connector has every public tool too.

When a weekly limit runs out, the tool says so in its answer, with the date it resets, and the public tools keep working. You can revoke a key at any time on the same page.

What the public connector can do

Every tool is read-only, idempotent and non-destructive, and reads public data only. Coverage: active jobs located in Finland plus remote roles open to people in Finland, in English, Finnish and Swedish.

Jobs

  • search_jobs: Search open jobs in Finland by text and 15 filters, with a link to each posting.
  • list_job_filters: The filter values present in open jobs right now, with counts, per language.
  • get_job_details: One listing in full: description, requirements, benefits, salary and the posting link.

Pay

  • calculate_net_salary_finland: Gross to net pay in Finland, every tax and contribution, and the employer's cost.

Hosts that support MCP Apps also show interactive cards for job search, a job and net salary, and the connector ships four skills (job search, salary expectations, CV and cover letter for the Finnish market) that teach an assistant how to use the tools well.

Reusing what the connector returns

Every result carries a dataUse block. Aggregate figures (pay ranges, counts, shares) are free to reuse, including commercially, with a visible link to the jobcrawls.com page they came from, or "JobCrawls (jobcrawls.com)" where a link is impossible, such as in a spoken answer. Individual job listings are not licensed for redistribution: link to the listing instead. Listings from Job Market Finland (Työmarkkinatori) carry the source line its terms of use require. See clause 7.5 of the terms.

Links in results carry ?ref=connector&tool= and the tool's name, so a click lands on the exact job, salary page or calculation the assistant talked about.

Reference: the job search tools

The rest of this page documents the four job search and net pay tools in detail.

  • Server URL: https://www.jobcrawls.com/api/connector
  • ChatGPT app endpoint: https://www.jobcrawls.com/api/connector/chatgpt (the same server; only the inline cards' sandbox domain differs, because ChatGPT and Claude each require their own)
  • Transport: Streamable HTTP, stateless (every request stands alone, no session to keep alive)
  • Authentication: none (public data)

Languages

Every listing exists in a separate English, Finnish and Swedish index, each with its own localized text and localized filter values. For example the remote value is Remote in en, Etätyö in fi and Distans in sv, and a field value such as Software Engineering only matches in the en index. The Finnish index has the most complete coverage of the Finnish job market.

  • Pass locale explicitly to choose the index. Use the language the user writes in, not the language of job titles or place names: “etsi React developer -töitä Espoosta” is Finnish, so fi.
  • When locale is omitted, search_jobs and list_job_filters detect it from the query and filter values, and calculate_net_salary_finland from the municipality name (for example “Helsingfors” reads as Swedish). Anything ambiguous, such as a bare job title or city name, stays English. get_job_details has no text to detect from and defaults to English.
  • Results, error messages for the user, the inline cards and the linked jobcrawls.com pages all follow the chosen locale.

Tool: search_jobs

Searches active job listings in Finland and returns a scoped, paginated list, each with a direct link to the individual posting. With no query and no filters it browses the newest listings.

ParameterTypeDescription
querystring (optional)Free-text search across title, description, skills, company and location. Typo-tolerant. Leave empty to browse.
localeen | fi | sv (optional)Language index to read from. When omitted, detected from the free text you pass (see Languages below).
filtersobject (optional)Facet filters keyed by attribute, each an array of allowed values. Values within one attribute are OR-combined; different attributes are AND-combined. Values are case-sensitive and must come from list_job_filters for the same locale. Allowed keys are listed below.
excludeFiltersobject (optional)Same shape and keys as filters, but drops listings that have any of the given values. For example { "requiredLanguages": ["Finnish"] } returns jobs that do not require Finnish. An attribute cannot appear in both filters and excludeFilters.
remoteOnlyboolean (optional)Only fully remote positions (works in every locale).
minSalaryinteger (optional)Only listings whose minimum salary is at least this amount (listing currency, usually EUR).
sortrelevance | date | salary (optional)relevance (default), date (newest first) or salary (highest minimum first).
titleOnlyboolean (optional)Match the query against job titles only, not descriptions or skills. Useful for counting ads that are for a role ("product manager") rather than ads that merely mention its words.
limitinteger 1 to 20 (optional)Results per page. Default 10.
pageinteger ≥1 (optional)Page number. Default 1.
includeFacetsboolean (optional)Also return facet values and counts for the current result set (including companyId, which answers “who is hiring most for this”), plus regions: job counts per Finnish region.

Filter keys

KeyTypeWhat it filters
fieldstring[]Professional field, e.g. Software Engineering, Healthcare.
normalisedTitlestring[]Normalised role title, e.g. Software Engineer, Nurse.
normalisedRoleLevelstring[]Seniority, e.g. Junior, Senior, Lead.
locationstring[]Town or city as stored in the index. Up to five values are expanded to every stored spelling of each town (Turku and Åbo match the same jobs); longer lists are matched as given.
regionTagsstring[]A Finnish region (maakunta), by the placeId returned in a previous result's regions.
remotenessstring[]Remote, hybrid or on-site, in the locale’s own wording.
jobTypestring[]Full-time, part-time, temporary, internship and so on.
companyIndustrystring[]Industry of the hiring company.
companyIdstring[]One specific employer, by the companyId in a result.
requiredLanguagesstring[]Languages the job requires.
optionalLanguagesstring[]Languages listed as an advantage.
skillsAndTechnologiesstring[]Skills and technologies, e.g. React, Python, forklift licence.
benefitsstring[]Benefits named in the listing.
educationLevelstring[]Required education level.
peopleManagementTierstring[]Whether and how much the role manages people.

What it returns

query, locale, page, pageSize, totalFound, returned, hasMore, results, and with includeFacets also facets (attribute to [{ value, count }], top 20 each) and regions ({ code, placeId, name, count } per region with jobs, largest first). Each result has:

FieldTypeDescription
idstringListing id, for get_job_details.
title, company, companyIdstringJob title, employer name and employer id.
location, remoteness, jobTypestring or string[]Where and how the job is done.
field, roleLevel, skills, languagesstring[]Classification, seniority, skills and required languages.
salaryobject or null{ min, max, currency, period } when known.
salaryIsEstimatebooleanTrue when the salary is a JobCrawls market-based estimate rather than a figure the employer stated.
marketSalaryobject or null{ p25, median, p75, sampleSize, currency, period }: the monthly pay band for comparable jobs. Only given next to an employer-stated salary, so the two can be compared.
employerGradestring or nullJobCrawls Employer Score as a letter grade (A is best).
postedDateYYYY-MM-DDWhen the listing was posted.
snippetstringThe first 320 characters of the description.
logoUrl, brandColorstring or nullCompany logo hosted by JobCrawls, and the brand colour when known.
urlstringDirect link to the posting on jobcrawls.com, in the requested locale.
isTyomarkkinatori, dataSourceboolean, stringMarks a listing from Job Market Finland (Työmarkkinatori), with the attribution its terms of use require.

Tool: list_job_filters

Returns the attributes you can filter jobs by, with the values currently present in active listings and how many listings have each value (up to 100 per attribute). The values are the exact strings search_jobs accepts for the same locale. Call this first whenever a search needs a filter.

ParameterTypeDescription
localeen | fi | sv (optional)Language index to read from. When omitted, detected from the free text you pass (see Languages below).
querystring (optional)Scope the values to matching listings, e.g. only the skills and locations present in "nurse" jobs.

Attributes returned: remoteness, jobType, field, normalisedRoleLevel, educationLevel, peopleManagementTier, location, companyIndustry, requiredLanguages, benefits and skillsAndTechnologies. The response also describes the two non-facet filters, minSalary and remoteOnly.

Tool: get_job_details

Returns the full detail for a single listing.

ParameterTypeDescription
jobIdstring (required)The id from a search_jobs result.
localeen | fi | sv (optional)Language of the returned content, normally the locale of the search the id came from. Default en. If the listing does not exist in that language, the connector returns it in the language it does exist in and says which.

Returns everything a search result has, plus description, requirements, responsibilities, benefits, educationLevel, languagesRequired, applicationDeadline, isActive, companyUrl and the locale the listing was found in.

Tool: calculate_net_salary_finland

Gross-to-net salary calculator for Finland, the same engine as the JobCrawls tax iceberg calculator. Pure arithmetic on the current tax year's official Finnish parameters; an estimate, not tax advice.

ParameterTypeDescription
grossnumber (gross or net required)Gross salary in euros, per month unless period is year.
netnumber (gross or net required)Target take-home pay instead of gross: the tool solves the gross salary that leaves this in hand.
periodmonth | year (optional)Period of every money amount given. Default month.
localeen | fi | sv (optional)Language of the notes, the card and the linked page. Detected from the municipality name when omitted, else en.
municipalitystring (optional)Finnish municipality, by its Finnish or Swedish name (Helsinki or Helsingfors, Turku or Åbo). Omit for the national average municipal tax rate.
employerSizesmall | large (optional)Employer payroll size, for the employer's unemployment insurance rate (large is a payroll above about EUR 2.5 million). Omit for a blended average.
includeVatboolean (optional)Also estimate the VAT paid when the net pay is spent.
ageinteger 15 to 100 (optional)Affects pension and unemployment contributions.
dependentChildreninteger 0 to 20 (optional)Affects the child tax deduction.
isSoleGuardianboolean (optional)Single parent with dependent children (child deduction).
commutingCostsnumber (optional)Commuting costs in the same period; deductible above the own-liability share, capped.
dividends, capitalGainsnumber (optional)Listed-company dividends and net capital gains (capital income).
unlistedDividends, unlistedNetAssetsnumber (optional)Dividends from the person's own unlisted company, and the mathematical value of those shares (a stock, not per period) for the 8% yield rule.

Church membership and trade-union fees are deliberately not inputs, because they are sensitive personal data. The result's pageUrl opens the same scenario on jobcrawls.com, where both can be set in the user's own browser.

What it returns

FieldTypeDescription
taxYear, currency, localenumber, EUR, stringThe tax year whose parameters were used.
inputobjectThe inputs after defaults, including the solved gross when a target net was given.
monthly, annualobjectFull breakdown per period: gross; employee pension, unemployment and daily-allowance contributions; state, municipal, medical-care, church and Yle taxes; deductions applied (commuting, earned-income credit); net pay; employer TyEL pension, unemployment, health, accident and group-life contributions; the true cost of employment; VAT on spending and net after VAT.
ratesobjectTax rate (the tax card rate), effective rate including employee contributions, employer contributions as % of gross, and the share of the employer cost the employee keeps.
assumptionsobjectMunicipal and church tax rates used, the municipality matched, the employer insurance assumption, and plain-language notes.
investmentsobject or nullCapital income breakdown, when investment income was given.
destinationsarrayWhere the taxes and contributions go (pensions, the state, the municipality and so on), EUR per year and share.
pageUrlstringThe same scenario on jobcrawls.com.
icebergSvgUrlstringA labelled tax iceberg illustration of this exact breakdown, as SVG.

Notes that come with results

When a result contains anything that needs explaining to the user, the tool adds a second text block headed Notes, so the assistant gets it with the data instead of relying on instructions:

  • Job Market Finland listings carry an attribution line that must be shown with the listing under Job Market Finland's terms of use.
  • Salaries with salaryIsEstimate: true are labelled as JobCrawls estimates wherever they are quoted.
  • employerGrade is a letter grade, never a number.

Interactive cards (MCP Apps)

In hosts that support MCP Apps (Claude and ChatGPT), three tools render an inline card next to the assistant's answer. The cards follow the host's light or dark theme and the requested locale. Every interactive control is only shown when the host supports it, so a host without a feature simply shows the plain card.

Search results

  • Job cards with company logo, salary, employer grade and a link to the posting, as a swipeable carousel or a compact list.
  • Filter chips that re-run the search on the server with one more filter added.
  • A fullscreen map of Finland's regions shaded by job count; tap a region to filter to it.
  • “More jobs” to load the next page without leaving the card.
  • “Ask about this” on any job, which sends a message to the assistant with the job id.

Job detail

  • Employer grade badge, an estimate tag on estimated salaries, and a pay-versus-market bar.
  • “What would I take home?” runs the net salary calculation on the listing's own salary.
  • A requirements checklist the user can tick, then “How well do I match?” or “Help me apply” hands the ticked list to the assistant.

Net salary

  • The tax iceberg: take-home pay above the waterline, taxes and employer contributions below.
  • A salary slider that recalculates live.
  • Compare two offers side by side on one scale, with the difference and how much of a raise you actually keep.

Skills

The connector also serves four skills over the MCP skills extension (skills/list and skills/get, with every file readable as a skill://jobcrawls/... resource). Hosts that import skills, such as ChatGPT plugins, use them to apply the tools the way an experienced Finnish job-search adviser would:

  • finland-job-search: understand what the user wants, pick filters, search, and present results with the required attributions. Triggers on “etsi töitä”, “lediga jobb”, “find jobs in Helsinki” and similar.
  • finland-salary-expectations: turn gross pay into take-home pay, compare it with what similar listings pay, and set a salary expectation the user can defend (“palkkatoive”, “lönekrav”).
  • finnish-cv: write, improve or tailor a CV to Finnish hiring conventions, optionally matched to a specific listing (“ansioluettelo”, “meritförteckning”).
  • finnish-cover-letter: write a short, specific application for a listing, or an open application (“työhakemus”, “personligt brev”).

Without MCP

The salary calculation is also available as plain HTTP, with the same inputs and engine:

  • JSON: https://www.jobcrawls.com/api/tax-iceberg?gross=4000&municipality=Helsinki
  • SVG illustration: https://www.jobcrawls.com/api/connector/iceberg?gross=4000&municipality=Helsinki
  • A page per salary, e.g. https://www.jobcrawls.com/en/tax-iceberg/4000-gross-income

Use-case examples

Worked examples, from prompt to what the connector does:

  1. Finding a role. “Find remote software engineering jobs in Helsinki paying at least 4000 a month.” The assistant calls list_job_filters to get the exact field and location values, then search_jobs with { query: "software engineer", locale: "en", filters: { field: ["Software Engineering"], location: ["Helsinki, Finland"] }, remoteOnly: true, minSalary: 4000 }.
  2. Jobs that do not require Finnish. “Which marketing jobs in Finland don't need Finnish?” search_jobs { query: "marketing", excludeFilters: { requiredLanguages: ["Finnish"] } }.
  3. Who is hiring. “Which companies have the most open nurse jobs, and in which regions?” search_jobs { query: "nurse", titleOnly: true, includeFacets: true } returns the employer counts in facets.companyId and the per-region counts in regions; a follow-up passes a region's placeId as filters.regionTags.
  4. Reading one listing in full. “Tell me more about the second result.” The assistant takes that result's id and calls get_job_details.
  5. Is this salary fair? “Is 3800 a month good for this job?” The listing's marketSalary band shows where an employer-stated salary sits against comparable jobs.
  6. Net salary in Finland. “Paljonko jää käteen 4200 euron bruttopalkasta Helsingissä?” (“What's left after tax from a 4200 euro gross salary in Helsinki?”) calculate_net_salary_finland { gross: 4200, municipality: "Helsinki", locale: "fi" } returns the monthly net, effective tax rate, employer cost and a link to the same scenario.
  7. What gross do I need? “What salary do I need in Tampere to take home 3000 a month?” calculate_net_salary_finland { net: 3000, municipality: "Tampere" } solves the gross.
  8. Applying. “Write a cover letter for this job.” The assistant reads the listing with get_job_details and follows the finnish-cover-letter skill.

Other prompts that work well:

  • “What are the newest marketing jobs in Finland? Give me 5.”
  • “Find junior Python jobs in Oulu or Tampere, newest first.”
  • “Vilka it-jobb finns i Åbo just nu?” (Swedish)
  • “Etsi kesätöitä Jyväskylästä.” (Finnish)

Troubleshooting

  • No results, or results in the wrong language. Each locale (en, fi, sv) is a separate index with its own localized filter values. Call list_job_filters with the same locale first and pass those exact values into search_jobs; an English filter value will not match in the fi or sv index.
  • “Unknown filter attribute”. The key is not one of the 15 filter keys above. The error lists the allowed keys.
  • “Present in both filters and excludeFilters”. An attribute cannot be both required and excluded in one call; drop it from one of the two.
  • “Job search is temporarily unavailable” or a retry message. Our search backend was briefly unreachable; it is not an authentication problem (the connector has no login). Wait a moment and try again. These messages come back in the user's language.
  • “No job found for id”. The listing has expired or been removed since it was returned by search_jobs. Run a new search rather than reusing an old id.
  • Unknown municipality. Use the Finnish or Swedish name of a Finnish municipality (Turku or Åbo), or omit it for the national average.
  • Connector not appearing in Claude. Confirm the server URL is exactly https://www.jobcrawls.com/api/connector, the transport is Streamable HTTP, and authentication is left empty; then reload the connector list.
  • Cards not showing. The host does not support MCP Apps, or has them turned off. The answer still works from the JSON result.
  • Anything else. Contact developers@jobcrawls.com.

Privacy

The connector returns only public job data and does not access your account, your conversation history or your files. The net salary tool takes no church membership or union fee inputs. See the AI assistant (connector) access section of our privacy policy.

How our crawler works

The job listings this connector searches come from our own crawler, which indexes public job postings across the web, and from Job Market Finland. See how our crawler works for its user agent, crawl behavior, and how to control it via robots.txt.