Server definition
- Hash
- sha256:7f0aa45ae06749e813aa3f85c13b93c03d18a8bb034a8c327c59532406285013
- What it is
- What a remote MCP server returned when asked what it offers: 7 tools
The blob, as servednamed by its sha256
{
"instructions": "Nectar Jobs indexes live job postings from employers' own careers pages, the job boards they publish through, and public employment services, in dozens of countries.\n\nWhich tool:\n- search_jobs: listings for a role, place, salary or skill. Pass `country` (ISO-2) when the user names a country; it is more precise than `location`.\n- aggregate_jobs: \"what's hiring\", \"how many\", \"what does X pay\" questions about a slice of the market, in one call instead of many searches.\n- job_trends: whether a slice is growing or shrinking over time.\n- recommend_jobs: when the user shares a CV or describes what they want. Needs a country or a location; ask where they can work rather than guessing.\n- find_similar_jobs / get_job: more like one posting, or one posting in full.\n\nPresenting results:\n- Link each job by its `url` (its page on Nectar Jobs, which shows the whole advert and stays current) and give its `apply_url` for applying on the employer's own site.\n- Say how old a posting is (`posted_at`). Postings close; check an older one with get_job before recommending it.\n- Salaries are in the posting's own currency and are not converted.\n- When you cite these results, attribute them to Nectar Jobs (nectarjobs.com).\n\nSearch and alerts on the site, with filters and a saved CV, are at https://nectarjobs.com.\n",
"tools": [
{
"description": "Aggregate counts for a filtered slice of the corpus — the tool for market/trend questions\n (\"what kinds of roles are hiring in Pune?\"), instead of issuing many limit-1 searches.\n\n Takes the same filters as search_jobs (keyword matching included, see its ``query`` note) and\n returns the slice's ``total`` plus breakdowns, each a {value: count} dict, biggest first:\n ``by_category`` (job function — the role-type axis), ``by_seniority``,\n ``by_employment_type`` (contract basis and hours in one axis; ``full_time`` is inflated because\n a posting silent about its hours is recorded as full-time), ``top_companies``,\n ``top_skills``, ``by_source``, ``benefits``, ``company_size``, ``lang``, and ``salary`` —\n per-currency posting counts with salary_max quartiles (currencies deliberately not blended).\n Every count collapses duplicate postings, so numbers are comparable to search totals. A\n breakdown on a field you filtered by lists only the values you filtered to.\n ",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Company"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"employment_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Employment Type"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"posted_since_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posted Since Days"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Remote"
},
"salary_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Salary Min"
},
"seniority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Seniority"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
}
},
"title": "aggregate_jobsArguments",
"type": "object"
},
"name": "aggregate_jobs",
"outputSchema": {
"additionalProperties": true,
"title": "aggregate_jobsDictOutput",
"type": "object"
}
},
{
"description": "Find jobs semantically similar to a given job (excludes its duplicates).\n\n At most ``max_per_company`` results per company (0 = uncapped; spellings of one employer, such\n as \"Thales\" and \"Thales Group\", count together), so one employer's near-identical\n postings don't fill the list; ``exclude_same_company`` drops the anchor's own company entirely\n (\"roles like this elsewhere\").",
"inputSchema": {
"properties": {
"exclude_same_company": {
"default": false,
"title": "Exclude Same Company",
"type": "boolean"
},
"job_id": {
"title": "Job Id",
"type": "integer"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
},
"max_per_company": {
"default": 3,
"title": "Max Per Company",
"type": "integer"
}
},
"required": [
"job_id"
],
"title": "find_similar_jobsArguments",
"type": "object"
},
"name": "find_similar_jobs",
"outputSchema": {
"additionalProperties": true,
"title": "find_similar_jobsDictOutput",
"type": "object"
}
},
{
"description": "Fetch a single job's full details, including its description and any\n duplicate postings of the same role on other sources.",
"inputSchema": {
"properties": {
"job_id": {
"title": "Job Id",
"type": "integer"
}
},
"required": [
"job_id"
],
"title": "get_jobArguments",
"type": "object"
},
"name": "get_job",
"outputSchema": {
"additionalProperties": true,
"title": "get_jobDictOutput",
"type": "object"
}
},
{
"description": "Return corpus-wide coverage: total jobs, counts by source, and top companies.\n For the same numbers on a filtered slice (a location, a company, a query), use\n aggregate_jobs.",
"inputSchema": {
"properties": {},
"title": "get_statsArguments",
"type": "object"
},
"name": "get_stats",
"outputSchema": {
"additionalProperties": true,
"title": "get_statsDictOutput",
"type": "object"
}
},
{
"description": "How a slice of the market has changed OVER TIME — use this for \"is X growing/shrinking\",\n \"hiring trend\", \"more or fewer than last year\". aggregate_jobs describes a slice as it stands\n today; this one shows its history.\n\n Takes the same filters as aggregate_jobs, plus ``bucket`` (\"day\"/\"week\"/\"month\"),\n ``since_days`` (at most 730), and ``measure``. Returns a ``series``, oldest first, each period carrying\n ``postings`` (roles dated to it, duplicates collapsed) and ``still_open`` (how many are live\n now — the rest have since closed).\n\n ``measure=\"posted\"`` (default) uses the employer's stated date: the market signal, but\n nullable, so check ``without_date`` — it counts roles the clock cannot place, and when it\n rivals the series totals the trend describes a minority of the slice.\n\n ``measure=\"first_seen\"`` uses when we first crawled the row. Complete, but it measures OUR\n coverage: a backfill or a newly onboarded board appears as a spike of hundreds of thousands\n that is not a hiring event. Use it to audit ingestion, not to infer demand.\n\n Either way, periods before ``earliest`` are empty because we hold no data that far back, not\n because hiring stopped — never report that as a decline.\n\n CRITICAL for \"posted\": only compare periods at or after ``crawl_started``. Earlier ones are\n left-censored — the first crawl could only capture roles still live when it ran, so anything\n posted before that and already closed was never seen. Those buckets undercount severely (their\n ``still_open`` sits near 100%, the giveaway), and reading across the boundary turns the\n crawler's start date into a fake hiring boom.\n ",
"inputSchema": {
"properties": {
"bucket": {
"default": "month",
"title": "Bucket",
"type": "string"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Company"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"employment_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Employment Type"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"measure": {
"default": "posted",
"title": "Measure",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Remote"
},
"salary_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Salary Min"
},
"seniority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Seniority"
},
"since_days": {
"default": 365,
"title": "Since Days",
"type": "integer"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
}
},
"title": "job_trendsArguments",
"type": "object"
},
"name": "job_trends",
"outputSchema": {
"additionalProperties": true,
"title": "job_trendsDictOutput",
"type": "object"
}
},
{
"description": "Rank jobs by how well they match a résumé or free-text description of what\n the candidate wants. Returns the best-matching jobs first.\n\n ``country`` (ISO-2, e.g. GB) or ``location`` (a city or region) is REQUIRED — ask the seeker\n where they can work rather than guessing. Semantic ranking over every country returns the\n nearest postings on earth, most of which the person cannot take.\n\n ``resume_text``: only about the first 400 words shape the ranking; anything after them is not\n read. For a longer CV, send what defines the person's next role first: the role they want,\n their headline, their recent roles and their key skills, not the whole document in order.\n\n Ranking is purely semantic; the filters are hard. ``seniority`` (intern, junior, senior,\n staff, principal, manager, director) filters to exactly that tag — many postings carry none,\n so only pass it when the seeker insists.",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"employment_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Employment Type"
},
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Remote"
},
"resume_text": {
"title": "Resume Text",
"type": "string"
},
"salary_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Salary Min"
},
"seniority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Seniority"
}
},
"required": [
"resume_text"
],
"title": "recommend_jobsArguments",
"type": "object"
},
"name": "recommend_jobs",
"outputSchema": {
"additionalProperties": true,
"title": "recommend_jobsDictOutput",
"type": "object"
}
},
{
"description": "Search live job postings: use when the user asks what jobs are open for a role, a place,\n a salary or a skill. Each job carries ``url`` (its page on Nectar Jobs) and ``apply_url``.\n\n Args:\n query: keyword or natural-language query. Words that name an occupation (\"manager\",\n \"software engineer\") are matched against the TITLE; other words match the whole\n document (title, company, description), so a generic word's ``total`` overcounts —\n to compare role-type volumes, use aggregate_jobs instead.\n location: city or country substring over the posting's location text (matches broadly:\n \"New York\" includes the whole state). For a whole country, prefer ``country``.\n remote: filter to remote (true) or on-site (false) roles.\n salary_min: only roles whose salary range reaches this amount (raw number — currencies\n are not converted, so only meaningful combined with a single-currency market).\n company: company name substring.\n source: restrict to one source/board; get_stats lists the live sources and their sizes.\n seniority: one of intern, junior, senior, staff, principal, manager, director.\n category: job function from the site taxonomy (Engineering, \"Data & ML\", Product, Design,\n Sales, Marketing, \"Customer Support\", Operations, \"Finance & Accounting\",\n \"People & HR\", Legal, \"IT & Security\", …) — aggregate_jobs reports the live values.\n country: 2-letter ISO code (\"US\", \"IN\") — matches the derived country, more precise than\n a ``location`` substring.\n employment_type: contract or hours — permanent, fixed_term, contract, freelance, temporary,\n casual, seasonal, internship, apprenticeship, graduate, working_student, volunteer,\n self_employed, full_time, part_time, job_share, shift, term_time. Contract basis and\n schedule are one filter; a posting carries one of each. Note that a posting which says\n nothing about its hours is recorded as ``full_time``, so that value is the least\n informative of the set.\n posted_since_days: only jobs posted within this many days.\n mode: \"hybrid\" (default, best), \"semantic\" (meaning-based), or \"keyword\" (exact).\n sort: \"relevance\" (default), \"date\" (newest first), or \"salary\" (highest first).\n page: 1-based page number, for paging past ``limit`` results.\n limit: max results per page (1-100).\n Returns a dict with ``total``, a ``jobs`` list (duplicates collapsed) and ``attribution``;\n when nothing matched, a ``hint`` names the filter most worth loosening.\n ",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Company"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"employment_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Employment Type"
},
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"mode": {
"default": "hybrid",
"title": "Mode",
"type": "string"
},
"page": {
"default": 1,
"title": "Page",
"type": "integer"
},
"posted_since_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Posted Since Days"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Remote"
},
"salary_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Salary Min"
},
"seniority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Seniority"
},
"sort": {
"default": "relevance",
"title": "Sort",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Source"
}
},
"title": "search_jobsArguments",
"type": "object"
},
"name": "search_jobs",
"outputSchema": {
"additionalProperties": true,
"title": "search_jobsDictOutput",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7f0aa45ae06749e813aa3f85c13b93c03d18a8bb034a8c327c59532406285013 | sha256sum