Skip to main content
Glama

HirePulse B2B Company Research

Company Open Jobs

get_company_open_jobs
Read-only

Company job postings lookup from a domain: open roles from public Greenhouse, Lever, Ashby, Workable, Recruitee and SmartRecruiters boards, with title, department, location, remote flag and published salary; up to 300 jobs, and new or closed jobs against known_job_ids. Use when an agent needs open roles or hiring signals for a company. $0.01; no board or no jobs is free.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "domain": "<domain>"
    },
    "name": "get_company_open_jobs"
  }
}

Input Schema

NameRequiredDescriptionDefault
domainYesHostname only, e.g. stripe.com; not a keyword or placeholder.
contextNoOptional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.
diff_onlyNoReturn only jobs that are not in known_job_ids. Needs known_job_ids.
known_job_idsNoJob IDs you already have from an earlier call. The answer then lists new and closed job IDs.

Output Schema

NameRequiredDescriptionDefault
codeNo
diffNo
jobsNo
noteNo
domainNo
statusNoOnly ok is charged.
sandboxNo
ats_typeNo
board_slugNo
checked_atNo
confidenceNohigh: the company website links to this board. unverified: only the board name matches the domain name.
next_stepsNoSuggested follow-up calls on the same domain, with the exact body. Optional to use.
board_matchNoname_match: the board name equals the first part of the domain, so check generic names.
remote_jobsNo
jobs_returnedNo
top_locationsNo
jobs_truncatedNo
next_poll_afterNoJob boards change slowly; calling again before this time is usually wasted.
jobs_with_salaryNo
top_technologiesNo
total_active_jobsNo
jobs_by_departmentNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / domain / description
      Previous value: -"Public domain without a URL scheme, path or port."New value: +"Hostname only, e.g. stripe.com; not a keyword or placeholder."
  2. Changed3 schema fields changed
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "ats_type": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_match": {
      -        "description": "name_match: the board name equals the first part of the domain, so check generic names.",
      -        "enum": [
      -          "name_match",
      -          "careers_page_link",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "checked_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "description": "high: the company website links to this board. unverified: only the board name matches the domain name.",
      -        "enum": [
      -          "high",
      -          "unverified",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "diff": {
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "jobs": {
      -        "items": {
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "jobs_by_department": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "jobs_returned": {
      -        "type": "integer"
      -      },
      -      "jobs_truncated": {
      -        "type": "boolean"
      -      },
      -      "jobs_with_salary": {
      -        "type": "integer"
      -      },
      -      "next_poll_after": {
      -        "description": "Job boards change slowly; calling again before this time is usually wasted.",
      -        "format": "date-time",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "next_steps": {
      -        "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use.",
      -        "items": {
      -          "properties": {
      -            "body": {
      -              "type": "object"
      -            },
      -            "mcp_tool": {
      -              "type": "string"
      -            },
      -            "price_usd": {
      -              "type": "number"
      -            },
      -            "tool": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            },
      -            "why": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "note": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "remote_jobs": {
      -        "type": "integer"
      -      },
      -      "sandbox": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "demo_domain": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "demo_domain",
      -          "note"
      -        ],
      -        "type": "object"
      -      },
      -      "status": {
      -        "description": "Only ok is charged.",
      -        "enum": [
      -          "ok",
      -          "no_open_jobs",
      -          "unreachable",
      -          "not_found"
      -        ],
      -        "type": "string"
      -      },
      -      "top_locations": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "top_technologies": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "total_active_jobs": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status",
      -      "jobs",
      -      "checked_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
      +  "ats_type": {},
      +  "board_match": {
      +    "description": "name_match: the board name equals the first part of the domain, so check generic names."
      +  },
      +  "board_slug": {},
      +  "checked_at": {},
      +  "code": {},
      +  "confidence": {
      +    "description": "high: the company website links to this board. unverified: only the board name matches the domain name."
      +  },
      +  "diff": {},
      +  "domain": {},
      +  "jobs": {},
      +  "jobs_by_department": {},
      +  "jobs_returned": {},
      +  "jobs_truncated": {},
      +  "jobs_with_salary": {},
      +  "next_poll_after": {
      +    "description": "Job boards change slowly; calling again before this time is usually wasted."
      +  },
      +  "next_steps": {
      +    "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use."
      +  },
      +  "note": {},
      +  "remote_jobs": {},
      +  "sandbox": {},
      +  "status": {
      +    "description": "Only ok is charged."
      +  },
      +  "top_locations": {},
      +  "top_technologies": {},
      +  "total_active_jobs": {}
      +}
  3. Changed3 schema fields changed
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "ats_type": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "board_match": {
      +        "description": "name_match: the board name equals the first part of the domain, so check generic names.",
      +        "enum": [
      +          "name_match",
      +          "careers_page_link",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "board_slug": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "checked_at": {
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "description": "high: the company website links to this board. unverified: only the board name matches the domain name.",
      +        "enum": [
      +          "high",
      +          "unverified",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "diff": {
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "domain": {
      +        "type": "string"
      +      },
      +      "jobs": {
      +        "items": {
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "jobs_by_department": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "jobs_returned": {
      +        "type": "integer"
      +      },
      +      "jobs_truncated": {
      +        "type": "boolean"
      +      },
      +      "jobs_with_salary": {
      +        "type": "integer"
      +      },
      +      "next_poll_after": {
      +        "description": "Job boards change slowly; calling again before this time is usually wasted.",
      +        "format": "date-time",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "next_steps": {
      +        "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use.",
      +        "items": {
      +          "properties": {
      +            "body": {
      +              "type": "object"
      +            },
      +            "mcp_tool": {
      +              "type": "string"
      +            },
      +            "price_usd": {
      +              "type": "number"
      +            },
      +            "tool": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            },
      +            "why": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "note": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "remote_jobs": {
      +        "type": "integer"
      +      },
      +      "sandbox": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "demo_domain": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "demo_domain",
      +          "note"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "description": "Only ok is charged.",
      +        "enum": [
      +          "ok",
      +          "no_open_jobs",
      +          "unreachable",
      +          "not_found"
      +        ],
      +        "type": "string"
      +      },
      +      "top_locations": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "top_technologies": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "total_active_jobs": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "domain",
      +      "status",
      +      "jobs",
      +      "checked_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "code": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "maximum": 599,
      +        "minimum": 400,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "code"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / description
      Removed value: -"Fields only; full schema in GET /v1/catalog."
    • removedOutput schema / properties
      Removed value: -{
      -  "ats_type": {},
      -  "board_match": {
      -    "description": "name_match: the board name equals the first part of the domain, so check generic names."
      -  },
      -  "board_slug": {},
      -  "checked_at": {},
      -  "code": {},
      -  "confidence": {
      -    "description": "high: the company website links to this board. unverified: only the board name matches the domain name."
      -  },
      -  "diff": {},
      -  "domain": {},
      -  "jobs": {},
      -  "jobs_by_department": {},
      -  "jobs_returned": {},
      -  "jobs_truncated": {},
      -  "jobs_with_salary": {},
      -  "next_poll_after": {
      -    "description": "Job boards change slowly; calling again before this time is usually wasted."
      -  },
      -  "next_steps": {
      -    "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use."
      -  },
      -  "note": {},
      -  "remote_jobs": {},
      -  "sandbox": {},
      -  "status": {
      -    "description": "Only ok is charged."
      -  },
      -  "top_locations": {},
      -  "top_technologies": {},
      -  "total_active_jobs": {}
      -}
  4. Changed3 schema fields changed
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "ats_type": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_match": {
      -        "description": "name_match: the board name equals the first part of the domain, so check generic names.",
      -        "enum": [
      -          "name_match",
      -          "careers_page_link",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "checked_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "description": "high: the company website links to this board. unverified: only the board name matches the domain name.",
      -        "enum": [
      -          "high",
      -          "unverified",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "diff": {
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "jobs": {
      -        "items": {
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "jobs_by_department": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "jobs_returned": {
      -        "type": "integer"
      -      },
      -      "jobs_truncated": {
      -        "type": "boolean"
      -      },
      -      "jobs_with_salary": {
      -        "type": "integer"
      -      },
      -      "next_poll_after": {
      -        "description": "Job boards change slowly; calling again before this time is usually wasted.",
      -        "format": "date-time",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "next_steps": {
      -        "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use.",
      -        "items": {
      -          "properties": {
      -            "body": {
      -              "type": "object"
      -            },
      -            "mcp_tool": {
      -              "type": "string"
      -            },
      -            "price_usd": {
      -              "type": "number"
      -            },
      -            "tool": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            },
      -            "why": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "note": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "remote_jobs": {
      -        "type": "integer"
      -      },
      -      "sandbox": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "demo_domain": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "demo_domain",
      -          "note"
      -        ],
      -        "type": "object"
      -      },
      -      "status": {
      -        "description": "Only ok is charged.",
      -        "enum": [
      -          "ok",
      -          "no_open_jobs",
      -          "unreachable",
      -          "not_found"
      -        ],
      -        "type": "string"
      -      },
      -      "top_locations": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "top_technologies": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "total_active_jobs": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status",
      -      "jobs",
      -      "checked_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
      +  "ats_type": {},
      +  "board_match": {
      +    "description": "name_match: the board name equals the first part of the domain, so check generic names."
      +  },
      +  "board_slug": {},
      +  "checked_at": {},
      +  "code": {},
      +  "confidence": {
      +    "description": "high: the company website links to this board. unverified: only the board name matches the domain name."
      +  },
      +  "diff": {},
      +  "domain": {},
      +  "jobs": {},
      +  "jobs_by_department": {},
      +  "jobs_returned": {},
      +  "jobs_truncated": {},
      +  "jobs_with_salary": {},
      +  "next_poll_after": {
      +    "description": "Job boards change slowly; calling again before this time is usually wasted."
      +  },
      +  "next_steps": {
      +    "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use."
      +  },
      +  "note": {},
      +  "remote_jobs": {},
      +  "sandbox": {},
      +  "status": {
      +    "description": "Only ok is charged."
      +  },
      +  "top_locations": {},
      +  "top_technologies": {},
      +  "total_active_jobs": {}
      +}
  5. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "ats_type": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_match": {
      -        "description": "name_match: the board name equals the first part of the domain, so check generic names.",
      -        "enum": [
      -          "name_match",
      -          "careers_page_link",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "board_slug": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "checked_at": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "confidence": {
      -        "description": "high: the company website links to this board. unverified: only the board name matches the domain name.",
      -        "enum": [
      -          "high",
      -          "unverified",
      -          null
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "diff": {
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "jobs": {
      -        "items": {
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "jobs_by_department": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "jobs_returned": {
      -        "type": "integer"
      -      },
      -      "jobs_truncated": {
      -        "type": "boolean"
      -      },
      -      "jobs_with_salary": {
      -        "type": "integer"
      -      },
      -      "next_poll_after": {
      -        "description": "Job boards change slowly; calling again before this time is usually wasted.",
      -        "format": "date-time",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "next_steps": {
      -        "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use.",
      -        "items": {
      -          "properties": {
      -            "body": {
      -              "type": "object"
      -            },
      -            "mcp_tool": {
      -              "type": "string"
      -            },
      -            "price_usd": {
      -              "type": "number"
      -            },
      -            "tool": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            },
      -            "why": {
      -              "type": "string"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "note": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "remote_jobs": {
      -        "type": "integer"
      -      },
      -      "status": {
      -        "description": "Only ok is charged.",
      -        "enum": [
      -          "ok",
      -          "no_open_jobs",
      -          "unreachable",
      -          "not_found"
      -        ],
      -        "type": "string"
      -      },
      -      "top_locations": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "top_technologies": {
      -        "additionalProperties": {
      -          "type": "integer"
      -        },
      -        "type": "object"
      -      },
      -      "total_active_jobs": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status",
      -      "jobs",
      -      "checked_at"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "ats_type": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "board_match": {
      +        "description": "name_match: the board name equals the first part of the domain, so check generic names.",
      +        "enum": [
      +          "name_match",
      +          "careers_page_link",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "board_slug": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "checked_at": {
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "description": "high: the company website links to this board. unverified: only the board name matches the domain name.",
      +        "enum": [
      +          "high",
      +          "unverified",
      +          null
      +        ],
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "diff": {
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "domain": {
      +        "type": "string"
      +      },
      +      "jobs": {
      +        "items": {
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "jobs_by_department": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "jobs_returned": {
      +        "type": "integer"
      +      },
      +      "jobs_truncated": {
      +        "type": "boolean"
      +      },
      +      "jobs_with_salary": {
      +        "type": "integer"
      +      },
      +      "next_poll_after": {
      +        "description": "Job boards change slowly; calling again before this time is usually wasted.",
      +        "format": "date-time",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "next_steps": {
      +        "description": "Suggested follow-up calls on the same domain, with the exact body. Optional to use.",
      +        "items": {
      +          "properties": {
      +            "body": {
      +              "type": "object"
      +            },
      +            "mcp_tool": {
      +              "type": "string"
      +            },
      +            "price_usd": {
      +              "type": "number"
      +            },
      +            "tool": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            },
      +            "why": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "note": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "remote_jobs": {
      +        "type": "integer"
      +      },
      +      "sandbox": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "demo_domain": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "demo_domain",
      +          "note"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "description": "Only ok is charged.",
      +        "enum": [
      +          "ok",
      +          "no_open_jobs",
      +          "unreachable",
      +          "not_found"
      +        ],
      +        "type": "string"
      +      },
      +      "top_locations": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "top_technologies": {
      +        "additionalProperties": {
      +          "type": "integer"
      +        },
      +        "type": "object"
      +      },
      +      "total_active_jobs": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "domain",
      +      "status",
      +      "jobs",
      +      "checked_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "code": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "maximum": 599,
      +        "minimum": 400,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "code"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnly and openWorld; the description adds real behavioral facts beyond that: which six ATS board providers are covered, a 300-job cap, that diffs return new and closed jobs relative to known_job_ids, and the $0.01 price with free results for no board/no jobs. It does not explain the payment/credential flow behind '$0.01', which for an open-world paid tool is the main remaining gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The coverage, return fields, limit, diff behavior, and price are packed into two tight sentences with the core resource front-loaded. It is dense but every clause carries information; slight cost is a run-on feel in the first sentence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, all four parameters are documented, and the annotations cover the safety profile, so the description's job is to add coverage, limits, and cost — which it does. For a read-only open-world lookup, an agent has enough to call it correctly, with billing mechanics being the only unstated detail.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3; the schema already explains domain formatting, diff_only's dependency on known_job_ids, and the meaning of known_job_ids. The description echoes the diff semantics ('new or closed jobs against known_job_ids') with slight added nuance but adds no format or limit guidance for the 5000-item known_job_ids array.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('Company job postings lookup from a domain') and enumerates the sources (Greenhouse, Lever, Ashby, Workable, Recruitee, SmartRecruiters) plus the returned fields (title, department, location, remote flag, salary). It is clearly distinguishable from generic lookups, though it never names or contrasts with the closely related siblings watch_company_jobs and get_company_hiring_intent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Use when an agent needs open roles or hiring signals for a company' gives a use context, but hiring signals is also plausibly what get_company_hiring_intent and watch_company_jobs cover, and no exclusion or selection rule is offered. The diff_only/known_job_ids pairing implies an incremental-refresh workflow but does not state when to prefer one-shot lookup vs monitoring.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.