Docs
ApplicantRead-only annotation

Find Matches

find_matches

Rank a catalog page using private preferences, role fit, company fit and employer requirements. Search constraints can only narrow saved hard requirements; conflicting residence states require clarification. Read effective_requirements, required_skill_coverage, ranking_components and next_questions. Missing evidence is not inability. Points are uncalibrated and not probabilities; sharing never boosts rank.

Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.

Parameters

NameContract
limit
Optional
integer
cursor
Optional
string
query
Optional
string
requirements
Optional
object

Exact input schema

Expand JSON Schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "maxLength": 300
    },
    "query": {
      "default": "",
      "type": "string",
      "maxLength": 200
    },
    "requirements": {
      "default": {},
      "type": "object",
      "properties": {
        "work_state": {
          "description": "US state of residence, e.g. TX. Only explicit eligibility evidence counts.",
          "type": "string",
          "enum": [
            "AL",
            "AK",
            "AZ",
            "AR",
            "CA",
            "CO",
            "CT",
            "DE",
            "DC",
            "FL",
            "GA",
            "HI",
            "ID",
            "IL",
            "IN",
            "IA",
            "KS",
            "KY",
            "LA",
            "ME",
            "MD",
            "MA",
            "MI",
            "MN",
            "MS",
            "MO",
            "MT",
            "NE",
            "NV",
            "NH",
            "NJ",
            "NM",
            "NY",
            "NC",
            "ND",
            "OH",
            "OK",
            "OR",
            "PA",
            "RI",
            "SC",
            "SD",
            "TN",
            "TX",
            "UT",
            "VT",
            "VA",
            "WA",
            "WV",
            "WI",
            "WY"
          ]
        },
        "fully_remote": {
          "type": "boolean"
        },
        "min_annual_base_usd": {
          "description": "USD annual base minimum; commission, estimates, and hourly conversions do not count.",
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000000
        },
        "max_travel_percent": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Output schema

Expand output contract
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {}
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}

Tool annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

← All applicant tools · Review and receipts