{
  "id": "ploid.v1.search",
  "object": "tool",
  "name": "Search People",
  "summary": "Search a live people index in plain English and rank up to 100 matches.",
  "description": "One-shot synchronous search over a continuously refreshed index of professional profiles. Returns ranked matches with a relevance score and per-person name, title, company, location, and LinkedIn URL (select which via contents.fields), plus search_time_ms and rows_indexed. Supports plain-English queries with optional title/company/location filters and three retrieval modes (instant, auto rerank, deep grading). A timed-out search returns partial results flagged by meta.warning. Suited for building prospect lists, sizing a persona, and low-latency people lookup inside agent tools. Pass a result's LinkedIn URL to /v1/enrich for profile, email, and phone.\n\nRaw ploid#v1/search endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://ploid.com/documentation/api/search).",
  "category": "lookup",
  "hosted_by": "Ploid",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "ploid",
      "name": "Ploid",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "ploid_v1_search",
  "input_schema": {
    "type": "object",
    "properties": {
      "body": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "maxLength": 4000,
            "description": "Who to find, in plain English — e.g. 'software engineers at fintech companies in San Francisco'."
          },
          "type": {
            "type": "string",
            "enum": [
              "instant",
              "auto",
              "deep"
            ],
            "description": "instant = retrieve quickly; auto (default) = retrieve and rerank; deep = apply a deeper grading path."
          },
          "num_results": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Max people to return (1-100; the vendor default is 25). Billing is per started block of 10 returned results."
          },
          "filters": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "company": {
                "type": "string"
              },
              "location": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "description": "Optional structured narrowing filters."
          },
          "contents": {
            "type": "object",
            "properties": {
              "fields": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "linkedin",
                    "title",
                    "company",
                    "location",
                    "name"
                  ]
                }
              }
            },
            "additionalProperties": false,
            "description": "Which person fields to include on each result."
          }
        },
        "required": [
          "query",
          "num_results"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "body"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}