Server definition

Hash: sha256:ba60ca8e69846fd7ad9459810d964ff6c2f3cf9d1f91683f5693392d677ce23d
What it is: What a remote MCP server returned when asked what it offers: 6 tools

The blob, as servednamed by its sha256

{
  "instructions": "Roleset is a normalized, change-tracked index of job postings taken from official\npublic ATS feeds (Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee, Personio).\n\nChoosing a tool:\n\n- Answering a question about the job market right now? `search_jobs`.\n- Tracking a market over time, or asked \"what's new\"? `job_changes`. It returns only\n  what opened, changed, closed or reopened, and a cursor to resume from. Never poll\n  `search_jobs` in a loop to detect change — that is what this tool is for.\n- Know the company? `company_jobs` for the roles, `hiring_signal` for whether they are\n  growing and in which departments.\n- Have a job id from an earlier result and need the full description? `get_job`.\n\nEvery result carries `as_of` and `last_crawled_min`, the oldest successful crawl behind\nthe rows returned. Every active board is crawled at least every 24 hours, so a posting\nthat closed in the last few hours may still appear as open. Say so when it matters.\n\nThe index holds no personal data: no applicants, no recruiter names or contact details.\nDo not ask it for any.",
  "tools": [
    {
      "description": "Every open posting at one company. Accepts a domain (acme.com), an ATS board slug, or the company name. Use when the company is already known and you want its roles; use search_jobs when you are looking across companies. For whether the company is growing rather than what it has open, use hiring_signal.",
      "inputSchema": {
        "properties": {
          "identifier": {
            "description": "Domain, ATS board slug, or company name.",
            "title": "Identifier",
            "type": "string"
          },
          "include_description": {
            "default": false,
            "title": "Include Description",
            "type": "boolean"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "title": "Limit",
            "type": "integer"
          }
        },
        "required": [
          "identifier"
        ],
        "title": "company_jobs_toolArguments",
        "type": "object"
      },
      "name": "company_jobs",
      "outputSchema": {
        "additionalProperties": true,
        "title": "company_jobs_toolDictOutput",
        "type": "object"
      }
    },
    {
      "description": "Fetch a single posting by its Roleset id, including the full description text and HTML. Use after search_jobs or job_changes when you need the body of a specific posting — for summarising requirements, or checking whether a role matches a candidate's constraints. The id comes from an earlier result.",
      "inputSchema": {
        "properties": {
          "job_id": {
            "description": "Roleset job id (UUID) from an earlier result.",
            "title": "Job Id",
            "type": "string"
          }
        },
        "required": [
          "job_id"
        ],
        "title": "get_job_toolArguments",
        "type": "object"
      },
      "name": "get_job",
      "outputSchema": {
        "additionalProperties": true,
        "title": "get_job_toolDictOutput",
        "type": "object"
      }
    },
    {
      "description": "Whether a company is hiring, and where. Returns open roles broken down by department plus how many opened and closed over the last 7 and 30 days, and the net change. Use for sales and research questions — 'is this company growing', 'are they building out engineering', 'did they stop hiring' — where counts and trend matter more than the individual postings. One call, not per record.",
      "inputSchema": {
        "properties": {
          "identifier": {
            "description": "Domain, ATS board slug, or company name.",
            "title": "Identifier",
            "type": "string"
          }
        },
        "required": [
          "identifier"
        ],
        "title": "hiring_signal_toolArguments",
        "type": "object"
      },
      "name": "hiring_signal",
      "outputSchema": {
        "additionalProperties": true,
        "title": "hiring_signal_toolDictOutput",
        "type": "object"
      }
    },
    {
      "description": "What has opened, changed, closed or reopened in the index. This is the tool to poll: pass `since` (ISO-8601) the first time, then keep passing the returned `meta.next_cursor` and you will see each event exactly once, with no gaps or repeats. Filter it the same way you would a search — by department, country, remote, title, company or ATS — to subscribe to one slice of the market. Each event carries the event type, when it happened, a `diff` showing which fields changed and their before/after values, and the job record itself. Use this to track a hiring market over time, to answer 'what's new since yesterday', or to keep a downstream store in sync. Defaults to the last 24 hours.",
      "inputSchema": {
        "properties": {
          "ats": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Ats"
          },
          "company": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Company"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ISO-3166 alpha-2, e.g. US.",
            "title": "Country"
          },
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Cursor"
          },
          "department": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Department, partial match.",
            "title": "Department"
          },
          "event": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "opened | updated | closed | reopened",
            "title": "Event"
          },
          "include_job": {
            "default": true,
            "title": "Include Job",
            "type": "boolean"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "title": "Limit",
            "type": "integer"
          },
          "remote": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Only remote, or only non-remote.",
            "title": "Remote"
          },
          "since": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ISO-8601; ignored when cursor is set.",
            "title": "Since"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Match on the job title.",
            "title": "Title"
          }
        },
        "title": "job_changes_toolArguments",
        "type": "object"
      },
      "name": "job_changes",
      "outputSchema": {
        "additionalProperties": true,
        "title": "job_changes_toolDictOutput",
        "type": "object"
      }
    },
    {
      "description": "Search the index of open job postings. Use for a one-off question about the job market: who is hiring for a role, what is open in a city or country, which companies have remote positions. Returns a page of job records plus a `meta.next_cursor` to continue; each record has title, company, structured locations, remote flag, employment type, salary when the board publishes one, and an apply URL. Descriptions are omitted unless `include_description` is set, because they are large. To find what has *changed* since you last looked, use job_changes instead — do not poll this tool in a loop.",
      "inputSchema": {
        "properties": {
          "ats": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Restrict to one ATS platform.",
            "title": "Ats"
          },
          "company": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Company name, partial match.",
            "title": "Company"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ISO-3166 alpha-2, e.g. US, DE.",
            "title": "Country"
          },
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "From a previous meta.next_cursor.",
            "title": "Cursor"
          },
          "department": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Department"
          },
          "employment_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "full_time | part_time | contract | intern | temporary | volunteer",
            "title": "Employment Type"
          },
          "include_description": {
            "default": false,
            "title": "Include Description",
            "type": "boolean"
          },
          "limit": {
            "default": 25,
            "maximum": 100,
            "minimum": 1,
            "title": "Limit",
            "type": "integer"
          },
          "listed_since_after": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ISO-8601. When the company last put the role on the market — it moves when a posting is reopened, so this is the filter for what is on the market now.",
            "title": "Listed Since After"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "City or region.",
            "title": "Location"
          },
          "posted_after": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ISO-8601 timestamp.",
            "title": "Posted After"
          },
          "q": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Free text over title and description.",
            "title": "Q"
          },
          "remote": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Only remote, or only non-remote.",
            "title": "Remote"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Match on the job title.",
            "title": "Title"
          }
        },
        "title": "search_jobs_toolArguments",
        "type": "object"
      },
      "name": "search_jobs",
      "outputSchema": {
        "additionalProperties": true,
        "title": "search_jobs_toolDictOutput",
        "type": "object"
      }
    },
    {
      "description": "Size and freshness of the whole index: companies, boards per ATS, open and total postings, events in the last 24 hours, and when the oldest active board was last crawled. Free. Use to tell a user how much coverage stands behind an answer, or to check the index is current before relying on it.",
      "inputSchema": {
        "properties": {},
        "title": "stats_toolArguments",
        "type": "object"
      },
      "name": "stats",
      "outputSchema": {
        "additionalProperties": true,
        "title": "stats_toolDictOutput",
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:ba60ca8e69846fd7ad9459810d964ff6c2f3cf9d1f91683f5693392d677ce23d | sha256sum