search

All MCP toolsRead

Semantic search over job-posting chunks; returns the top matching chunks of the postings in the shared marketplace, best first. Every returned hit is logged as an impression. The market read is the same on both faces: an organization reaches a person only through its own postings (match, get_job_people, incoming candidate interest).

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Natural-language search query."
    },
    "source": {
      "description": "The document kind; \"job\" (the default) is the only kind.",
      "type": "string",
      "enum": [
        "job"
      ]
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Chunk id — the fusion key for hybrid search."
          },
          "ownerType": {
            "type": "string",
            "enum": [
              "person",
              "job"
            ],
            "description": "What owns the chunk."
          },
          "ownerId": {
            "type": "string",
            "description": "The owning persons.id / jobs.id."
          },
          "section": {
            "type": "string",
            "description": "The document section the chunk came from."
          },
          "text": {
            "type": "string",
            "description": "The chunk text."
          },
          "similarity": {
            "type": "number",
            "description": "Cosine similarity, 0..1."
          }
        },
        "required": [
          "id",
          "ownerType",
          "ownerId",
          "section",
          "text",
          "similarity"
        ],
        "additionalProperties": false,
        "description": "One semantic-search hit over resume and job-posting chunks."
      },
      "description": "The top matching chunks, best first."
    }
  },
  "required": [
    "results"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}