Server definition
- Hash
- sha256:7333fc06692d7b0fc4d4188f8f4b0ae22e692b1d476184b2bf86c861f36e1bc3
- What it is
- What a remote MCP server returned when asked what it offers: 3 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Retrieve the name and description of the company behind a job, by job ID.\n\nUse this tool when users want more detail about a company than search_jobs/get_job_details\nreturn (e.g. after finding a job and wanting to know more about the company that posted it).\nDO NOT use for: searching/discovering companies or jobs by keyword (use search_jobs instead).\n\nLLM USAGE INSTRUCTIONS:\n- The typical flow is: search_jobs to find jobs -> user picks one -> offer to look up the\n company -> if the user agrees, call this tool with that same job_id (the same guid used\n for get_job_details; no separate lookup step is needed first).\n- Do not call this automatically right after get_job_details; ask the user first unless\n they already explicitly asked for company details.\n- Not every company has published an employer branding profile, and some profiles are\n marked not visible by the company. When that happens this tool does NOT raise — it\n returns a Company with `message` set and empty name/desc. Relay that message to the\n user (e.g. \"Looks like that company hasn't published a public profile.\") rather than\n treating it as an error.\n\nArgs:\n job_id: The unique identifier of the job whose company to look up (required). This\n must be the job's `guid` field from a search_jobs result, NOT its `id` field —\n `id` is a different, internal identifier that this tool does not accept.\n\nReturns:\n Company: Contains:\n - name: The company name (empty if message is set)\n - desc: The company description (empty if message is set)\n - message: Set instead of name/desc when there is no visible company profile\n to show; None when name/desc are populated\n\nRaises:\n Exception: If the job is not found, an API call itself fails (network error,\n non-200 response, GraphQL errors), or input validation errors occur\n",
"inputSchema": {
"properties": {
"job_id": {
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "get_company",
"outputSchema": {
"description": "Parsed company details returned by the get_company tool.",
"properties": {
"desc": {
"default": "",
"description": "The company description",
"type": "string"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Set instead of name/desc when there is no visible company profile to show (e.g. the company hasn't published one, or has marked it not visible). None when name/desc are populated."
},
"name": {
"default": "",
"description": "The company name",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Retrieve a job's full description and associated skills by job ID.\n\nUse this tool when users want more detail about a specific job than search_jobs returns\n(e.g. after finding a job via search_jobs and wanting its full description and skills list).\nDO NOT use for: searching/discovering jobs by keyword (use search_jobs instead).\n\nLLM USAGE INSTRUCTIONS:\n- Only call this after the user has picked out a specific job from search_jobs results\n (or otherwise supplied a job's guid directly) — do not call it speculatively for every\n search result.\n- After returning job details, do NOT automatically call get_company. Instead, offer to\n look up the company (e.g. \"Want me to pull up more info on the company?\") and only call\n get_company, passing this same job_id, if the user says yes.\n\nArgs:\n job_id: The unique identifier of the job to retrieve (required). This must be the\n job's `guid` field from a search_jobs result, NOT its `id` field — `id` is a\n different, internal identifier that this tool does not accept.\n\nReturns:\n JobDetails: Contains:\n - description: The full job description\n - skills: List of Skill objects associated with the job\n\nRaises:\n Exception: If the API call fails, the job is not found, or input validation errors occur\n",
"inputSchema": {
"properties": {
"job_id": {
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "get_job_details",
"outputSchema": {
"$defs": {
"Skill": {
"description": "A single job skill.",
"properties": {
"name": {
"description": "The skill name",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"description": "Parsed job details returned by the get_job_details tool.",
"properties": {
"description": {
"default": "",
"description": "The job description",
"type": "string"
},
"skills": {
"description": "Skills associated with the job",
"items": {
"$ref": "#/$defs/Skill"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Search for job listings by keyword, location, and filters. Returns job details, company info, and application links.\n\nUse this tool when users want to find jobs, search employment opportunities, or explore job openings.\nDO NOT use for: applying to jobs, submitting applications, or making employment decisions.\n\nLLM USAGE INSTRUCTIONS:\n- ALWAYS provide the keyword parameter (required)\n- When presenting results to users, include BOTH the job details URL (detailsPageUrl)\n AND the company page URL (companyPageUrl) for each job\n- Use location to find geographically relevant positions\n- Combine filters to refine searches (e.g., workplace_types=['Remote'] for remote work)\n- Use posted_date to find recent openings ('ONE'=1 day, 'THREE'=3 days, 'SEVEN'=7 days)\n- Default jobs_per_page is reasonable, increase for comprehensive searches\n- Use company_name to scope results to a specific employer\n- Use sort='datePosted' when the user wants the newest listings instead of the most relevant\n- Use facets to get aggregate counts (e.g., how many results are remote vs on-site) without paging through all results\n- After presenting results, do NOT automatically call get_job_details for every job returned.\n Wait for the user to indicate which specific job(s) they're interested in, then pass that\n job's guid to get_job_details.\n\nIMPORTANT - AI DISCLOSURE REQUIREMENT:\nWhen presenting job search results to users, you MUST include an appropriate disclosure\nthat these results were retrieved using AI assistance. Example disclosure language:\n\"These job listings were found using AI-powered search. Please review all job details\ncarefully and verify information directly with employers before applying.\"\n\nThis tool provides job listing data only. Final employment decisions should always\ninvolve human judgment and direct review of complete job postings.\n\nArgs:\n keyword: The job keyword or title to search for (required)\n location: Geographic location for the job search (city, state, country)\n radius: Search radius from the specified location (minimum 1, requires radius_unit)\n radius_unit: Unit for search radius. Options: 'mi', 'km' (requires radius)\n jobs_per_page: Number of jobs to return per page (1-100, defaults to 5)\n page_number: Page number for pagination (1-based, default is 1)\n sort: Sort order for results. Options: 'relevance', 'datePosted' (defaults to relevance)\n posted_date: Filter by posting date. Options: 'ONE' (1 day), 'THREE' (3 days), 'SEVEN' (7 days)\n workplace_types: Workplace arrangements. Options: 'Remote', 'On-Site', 'Hybrid'\n employment_types: Employment types. Options: 'FULLTIME', 'CONTRACTS', 'PARTTIME', 'THIRD_PARTY', 'INTERNSHIP'\n employer_types: Employer types. Options: 'Direct Hire', 'Recruiter', 'Other'\n willing_to_sponsor: Filter for employers willing to sponsor work authorization (boolean)\n easy_apply: Filter for jobs with easy application process (boolean)\n company_name: Filter by company name\n fields: Specific fields to include in response (optional, returns all exposed fields by default)\n facets: Facet dimensions to aggregate (optional). Options: 'employmentType', 'postedDate',\n 'workFromHomeAvailability', 'workplaceTypes', 'employerType', 'easyApply', 'isRemote',\n 'willingToSponsor'\n\nReturns:\n JobSearchResult: Contains:\n - data: List of JobDisplayFields with job details including:\n * guid: The job's identifier to pass as job_id to get_job_details for the full\n description and skills list (NOT the `id` field, which is a different, internal\n identifier not accepted by get_job_details)\n * detailsPageUrl: Direct link to full job posting\n * companyPageUrl: Link to company profile page\n * title, summary, salary, location, employmentType, etc.\n - metadata: Search metadata with pagination info and facet results\n\nRaises:\n Exception: If API call fails or input validation errors occur\n",
"inputSchema": {
"properties": {
"company_name": {
"default": null,
"type": "string"
},
"easy_apply": {
"default": null,
"type": "boolean"
},
"employer_types": {
"default": null,
"items": {
"type": "string"
},
"type": "array"
},
"employment_types": {
"default": null,
"items": {
"type": "string"
},
"type": "array"
},
"facets": {
"default": null,
"items": {
"type": "string"
},
"type": "array"
},
"fields": {
"default": null,
"items": {
"type": "string"
},
"type": "array"
},
"jobs_per_page": {
"default": null,
"type": "integer"
},
"keyword": {
"type": "string"
},
"location": {
"default": null,
"type": "string"
},
"page_number": {
"default": null,
"type": "integer"
},
"posted_date": {
"default": null,
"type": "string"
},
"radius": {
"default": null,
"type": "integer"
},
"radius_unit": {
"default": null,
"type": "string"
},
"sort": {
"default": null,
"type": "string"
},
"willing_to_sponsor": {
"default": null,
"type": "boolean"
},
"workplace_types": {
"default": null,
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "search_jobs",
"outputSchema": {
"$defs": {
"FacetQueryResult": {
"description": "Facet results for filtering.",
"properties": {
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable facet name"
},
"facetName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "System facet name"
},
"facetResults": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/FacetResultItem"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Individual facet result items"
}
},
"type": "object"
},
"FacetResultItem": {
"description": "Individual facet result item.",
"properties": {
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of jobs matching this facet value"
},
"displayValue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable facet value"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "boolean"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "System facet value"
}
},
"type": "object"
},
"JobDisplayFields": {
"description": "Job listing information with all facade-exposed fields.\n\nInternal atomic-service fields (jobId, positionId, companyLogoUrlOptimized,\njobMetadata, debug) exist upstream but are not exposed through the facade.",
"properties": {
"clientBrandId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Client brand identifier"
},
"companyLogoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "URL to the company logo"
},
"companyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Name of the hiring company"
},
"companyPageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "URL to the company page"
},
"detailsPageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "URL to the full job details page"
},
"easyApply": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the job offers easy application"
},
"employerType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Type of employer"
},
"employmentType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Type of employment"
},
"guid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Global unique identifier for the job"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Unique job identifier"
},
"isHighlighted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the job is highlighted/featured"
},
"isRemote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the job is fully remote"
},
"jobLocation": {
"anyOf": [
{
"$ref": "#/$defs/JobLocation"
},
{
"type": "null"
}
],
"default": null,
"description": "Job location information"
},
"modifiedDate": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Date when the job was last modified"
},
"postedDate": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Date when the job was posted"
},
"salary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Salary information if available"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Relevance score for the job match"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Brief job description"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Job title"
},
"willingToSponsor": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether employer is willing to sponsor work authorization"
},
"workFromHomeAvailability": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Work from home options"
},
"workplaceTypes": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Available workplace types"
}
},
"type": "object"
},
"JobLocation": {
"description": "Job location information.",
"properties": {
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable location name"
}
},
"type": "object"
},
"JobSearchMetadata": {
"description": "Metadata about the search results and pagination.",
"properties": {
"facetQueryResults": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/FacetQueryResult"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Facet results for filtering options"
},
"includeRemote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether remote jobs are included in results"
},
"page": {
"description": "Current page number (1-based)",
"minimum": 1,
"type": "integer"
},
"pageSize": {
"description": "Number of results per page",
"minimum": 1,
"type": "integer"
},
"recommendedSearches": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Recommended related searches"
},
"searchId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Unique identifier for this search"
},
"searchedLocation": {
"anyOf": [
{
"$ref": "#/$defs/SearchedLocation"
},
{
"type": "null"
}
],
"default": null,
"description": "Information about the searched location"
},
"selectedFilters": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/SelectedFilter"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Currently applied filters"
},
"sortBy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Current sort order"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total number of jobs matching the search criteria"
},
"totalJobCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total job count across all sources"
},
"totalPages": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total number of pages available"
}
},
"required": [
"page",
"pageSize"
],
"type": "object"
},
"SearchedLocation": {
"description": "Information about the searched location.",
"properties": {
"countryCode2": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Two-letter country code"
},
"radius": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Search radius used"
},
"radiusUnit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Unit for the search radius"
}
},
"type": "object"
},
"SelectedFilter": {
"description": "Currently applied filter.",
"properties": {
"displayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable filter name"
},
"filterName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "System filter name"
},
"selectedItems": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/SelectedFilterItem"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Selected filter items"
}
},
"type": "object"
},
"SelectedFilterItem": {
"description": "Individual selected filter item.",
"properties": {
"displayValue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable selected value"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "System selected value"
}
},
"type": "object"
}
},
"description": "Job search results with pagination metadata.",
"properties": {
"data": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/JobDisplayFields"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Array of job listings matching the search criteria"
},
"metadata": {
"anyOf": [
{
"$ref": "#/$defs/JobSearchMetadata"
},
{
"type": "null"
}
],
"default": null,
"description": "Metadata about the search results and pagination"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7333fc06692d7b0fc4d4188f8f4b0ae22e692b1d476184b2bf86c861f36e1bc3 | sha256sum