Techmap Job Postings
LocalAbout Techmap Job Postings
Techmap Job Postings is an MCP server that gives AI assistants and agents access to job listings and historical data across countries. It supports filtered searches, counts, filter-value discovery, and RSS feed URL generation.
Key features
- 01Search postings with detailed filters
- 02Count matching job listings
- 03Find common filter values and counts
- 04Generate filtered RSS feed URLs
- 05Access postings history dating to 2020
Use cases
- 01Find remote roles by location and date
- 02Count postings for labour-market research
- 03Build a filtered job-board RSS feed
MCP support
The MCP server exposes job search, counting, filter-value lookup, and RSS URL generation tools to MCP clients. Search and count requests use the Techmap Jobs API.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @techmap/mcp-serverTECHMAP_RAPIDAPI_KEYSecretRapidAPI key subscribed to the Techmap Jobs API (free plan: 1,000 job postings/month)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | No | City of the workplace |
| page | integer | No | Result page (10 postings per page), default 1 |
| sort | enum | No | newest = most recently collected jobs first (default), oldest = stable order for paging through all resultsnewest | oldest |
| state | string | No | State/region of the workplace |
| title | string | No | Search in the job title. Comma = OR, prefix + = must contain, prefix - = exclude, quotes = exact phrase, e.g. "data engineer",-senior (exact phrase "data engineer", excluding senior) |
| skills | string | No | Skill or keyword, e.g. "python"; same comma/+/- syntax as title |
| company | string | No | Hiring company name |
| industry | string | No | Industry, e.g. "healthcare" |
| isDirect | boolean | No | Only postings that link directly to the employer |
| language | string | No | ISO 639-1 language of the posting, e.g. "en" |
| workType | string | No | fulltime, parttime, flextime … |
| hasSalary | boolean | No | Only postings with salary information |
| workPlace | string | No | remote, hybrid, onsite, field or offshore (use list_filter_values for all values) |
| occupation | string | No | Occupation stem extracted from the title, e.g. "developer", "nurse" |
| countryCode | string | No | ISO 3166-1 alpha-2 country code of the job location, e.g. "de", "us", "lu"; "##" for postings without a country (mostly remote). Several codes can be combined with commas, e.g. "de,at,ch" |
| dateCreated | string | No | Day (YYYY-MM-DD) or month (YYYY-MM) the job was posted. If neither dateCreated nor dateCreatedMin/Max is set, the API uses the day two days ago (the most recent complete day) |
| isRecruiter | boolean | No | true = only recruiting firms, false = exclude them |
| contractType | string | No | permanent, temporary, internship … |
| dateCreatedMax | string | No | End of a posting date range (YYYY-MM-DD); use together with dateCreatedMin |
| dateCreatedMin | string | No | Start of a posting date range (YYYY-MM-DD); use together with dateCreatedMax |
Details
From the project READMETechmap Job Postings MCP Server
An MCP server that gives AI assistants and agents access to Techmap's job postings data: about 8 million new postings per month from 185 sources (company career pages and ATS platforms, job boards, aggregators and public employment offices) in 250 countries and territories, with history since 2020.
Use it to ask things like:
- "Find remote Python developer jobs posted in Germany this week."
- "How many nursing jobs were posted in Austria in September?"
- "Which companies in Luxembourg are hiring controllers?"
- "Build an RSS feed URL for hybrid marketing jobs in the Netherlands for my job board."
Tools
| Tool | What it does | API requests |
|---|---|---|
search_jobs | Search postings by country, title, occupation, skills, company, city, work place (remote/hybrid/onsite), contract/work type, language, industry, posting date, salary and direct-employer flags. Returns 10 postings per page. | 1 per page |
count_jobs | Count postings that match the same filters - for labour market questions. | 1 |
list_filter_values | List the most common values of a filter field (work place, industry, occupation, skills, company, city …) in the last 30 days with posting counts - to find exact filter values or the top companies/skills. Needs a PRO plan or higher. | 1 |
get_rss_feed_url | Build a filtered RSS feed URL for job board backfill (with a key placeholder). | none |
Setup
- Get a RapidAPI key and subscribe to the Techmap Jobs API. The free BASIC plan includes 1,000 job postings per month (1 request per second); paid usage is $1 per 1,000 postings.
- Add the server to your MCP client.
Claude Desktop / Claude Code / Cursor (mcpServers config):
{
"mcpServers": {
"techmap-jobs": {
"command": "npx",
"args": ["-y", "@techmap/mcp-server"],
"env": { "TECHMAP_RAPIDAPI_KEY": "your-rapidapi-key" }
}
}
}
Claude Code (CLI):
claude mcp add techmap-jobs -e TECHMAP_RAPIDAPI_KEY=your-rapidapi-key -- npx -y @techmap/mcp-server
Smithery: install from smithery.ai/servers/techmap/job-postings and enter your RapidAPI key when asked.
Your key stays on your machine; the server only sends it to RapidAPI. Usage is billed by RapidAPI on your own plan.
More data
- API documentation and OpenAPI specs: https://api.techmap.io
- Daily data feeds and historical datasets per country (gzipped JSON Lines on AWS Data Exchange): https://jobdatafeeds.com/pricing
- Free samples: Hugging Face, Kaggle
Development
npm install
npm test # unit tests with a mocked API
TECHMAP_RAPIDAPI_KEY=... npx @modelcontextprotocol/inspector node build/src/index.js
License
MIT - © Techmap GmbH, Karlsruhe, Germany
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.