StepStone MCP server for AI agents
Let Claude, ChatGPT or your own agent read StepStone: 2 typed functions through one MCP server. No StepStone API key needed.
- Site
- stepstone.de
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just StepStone
An MCP server for StepStone alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/stepstoneEvery site
One MCP server for StepStone and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
jobReturns one stepstone.de job posting in full from the id a search row carries (or the posting URL): title, employer, location, employment type…Arguments
Name Type Required idstringThe posting id a search row carries.No urlstringOr the posting URL itself (a search row's url); pass one of the two.No Returns
StepstoneJobinterface StepstoneJob { id: string; title: string; url: string; companyName: string | null; companyUrl: string | null; location: string | null; employmentType: string | string[] | null; industry: string | null; datePosted: string | null; validThrough: string | null; directApply: boolean | null; description: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stepstone/jobCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stepstone.job({ id: "14538729" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stepstone.job({"id": "14538729"}))curl -X POST https://api.bowmark.ai/v1/sites/stepstone/job \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"14538729"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stepstone.job({ id: "14538729" });searchSearches StepStone, the German job board, for postings by keyword or job title and an optional city or region, the same search a person runs on…Arguments
Name Type Required querystringYes locationstringNo pagenumberNo Returns
StepstoneSearchResponseinterface StepstoneSalary { min: number | null; max: number | null; currency: string | null; period: string | null; type: string | null } interface StepstoneJobRow { id: string; title: string; companyName: string; location: string; url: string; datePosted: string | null; snippet: string; salary: StepstoneSalary | null; workFromHome: string | null; labels: string[] } interface StepstoneSearchResponse { jobs: StepstoneJobRow[]; total: number; page: number; pageCount: number; url: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stepstone/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stepstone.search({ query: "software engineer", location: "Berlin" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stepstone.search({"query": "software engineer", "location": "Berlin"}))curl -X POST https://api.bowmark.ai/v1/sites/stepstone/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"software engineer","location":"Berlin"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stepstone.search({ query: "software engineer", location: "Berlin" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/stepstone/<function> - OpenAPI
/v1/sites/stepstone/openapi.json