Skip to main content
Glama
Sign In

HirePulse Company Research

by xyz.gethirepulse.api
OverviewDiscussionsAdmin

Batch Company Lookup

batch_lookup
Read-only

Company list enrichment for up to 50 domains in one request: tech stack, open jobs, hiring intent, Google Ads or the full company profile per row. The scan is free and returns a quote_id priced for the rows with data; empty rows are free, at most $1.00 per call. A quote does not authorize payment. Use when an agent enriches a prospect list. One domain: get_company_profile.

Input Schema

NameRequiredDescriptionDefault
toolNoData tool to run for each domain during quote creation; omit when redeeming a quote_id.
contextNoOptional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.
domainsNoPublic company domains without a URL scheme, path or port.
quote_idNoquote_id from step 1. Send it alone to pay and receive the results.

Output Schema

NameRequiredDescriptionDefault
codeNo
coldNohot-buyers: domains below the threshold, free.
nextNo
statusNoquote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.
resultsNoPaid rows, after step 2.
sandboxNo
quote_idNo
statusesNoStatus of every domain, free.
price_usdNo
expires_atNo
billable_countNo
price_micro_usdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • removedInput schema / allOf
      Removed value: -[
-  {
-    "if": {
-      "properties": {
-        "tool": {
-          "const": "company-profile"
-        }
-      },
-      "required": [
-        "tool"
-      ]
-    },
-    "then": {
-      "properties": {
-        "domains": {
-          "maxItems": 33
-        }
-      }
-    }
-  }
-]
    • addedInput schema / description
      Added value: +"Create a quote with tool and domains (1–50; at most33 for company-profile), OR redeem with quote_id and neither tool nor domains. These mutually exclusive modes are validated by the server."
    • removedInput schema / oneOf
      Removed value: -[
-  {
-    "not": {
-      "required": [
-        "quote_id"
-      ]
-    },
-    "required": [
-      "tool",
-      "domains"
-    ]
-  },
-  {
-    "not": {
-      "anyOf": [
-        {
-          "required": [
-            "tool"
-          ]
-        },
-        {
-          "required": [
-            "domains"
-          ]
-        }
-      ]
-    },
-    "required": [
-      "quote_id"
-    ]
-  }
-]
    • removedOutput schema / anyOf
      Removed value: -[
-  {
-    "properties": {
-      "billable_count": {
-        "type": "integer"
-      },
-      "cold": {
-        "description": "hot-buyers: domains below the threshold, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "expires_at": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "next": {
-        "type": "string"
-      },
-      "price_micro_usd": {
-        "type": "integer"
-      },
-      "price_usd": {
-        "type": "number"
-      },
-      "quote_id": {
-        "type": "string"
-      },
-      "results": {
-        "description": "Paid rows, after step 2.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "sandbox": {
-        "additionalProperties": false,
-        "properties": {
-          "demo_domain": {
-            "const": true,
-            "type": "boolean"
-          },
-          "note": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "demo_domain",
-          "note"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
-        "enum": [
-          "quote",
-          "nothing_billable",
-          "ok"
-        ],
-        "type": "string"
-      },
-      "statuses": {
-        "description": "Status of every domain, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "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: +{
+  "billable_count": {},
+  "code": {},
+  "cold": {
+    "description": "hot-buyers: domains below the threshold, free."
+  },
+  "expires_at": {},
+  "next": {},
+  "price_micro_usd": {},
+  "price_usd": {},
+  "quote_id": {},
+  "results": {
+    "description": "Paid rows, after step 2."
+  },
+  "sandbox": {},
+  "status": {
+    "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results."
+  },
+  "statuses": {
+    "description": "Status of every domain, free."
+  }
+}
  2. Changed6 schema fields changed
    • addedInput schema / allOf
      Added value: +[
+  {
+    "if": {
+      "properties": {
+        "tool": {
+          "const": "company-profile"
+        }
+      },
+      "required": [
+        "tool"
+      ]
+    },
+    "then": {
+      "properties": {
+        "domains": {
+          "maxItems": 33
+        }
+      }
+    }
+  }
+]
    • removedInput schema / description
      Removed value: -"Create a quote with tool and domains (1–50; at most33 for company-profile), OR redeem with quote_id and neither tool nor domains. These mutually exclusive modes are validated by the server."
    • addedInput schema / oneOf
      Added value: +[
+  {
+    "not": {
+      "required": [
+        "quote_id"
+      ]
+    },
+    "required": [
+      "tool",
+      "domains"
+    ]
+  },
+  {
+    "not": {
+      "anyOf": [
+        {
+          "required": [
+            "tool"
+          ]
+        },
+        {
+          "required": [
+            "domains"
+          ]
+        }
+      ]
+    },
+    "required": [
+      "quote_id"
+    ]
+  }
+]
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "properties": {
+      "billable_count": {
+        "type": "integer"
+      },
+      "cold": {
+        "description": "hot-buyers: domains below the threshold, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "expires_at": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "next": {
+        "type": "string"
+      },
+      "price_micro_usd": {
+        "type": "integer"
+      },
+      "price_usd": {
+        "type": "number"
+      },
+      "quote_id": {
+        "type": "string"
+      },
+      "results": {
+        "description": "Paid rows, after step 2.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "sandbox": {
+        "additionalProperties": false,
+        "properties": {
+          "demo_domain": {
+            "const": true,
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "demo_domain",
+          "note"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
+        "enum": [
+          "quote",
+          "nothing_billable",
+          "ok"
+        ],
+        "type": "string"
+      },
+      "statuses": {
+        "description": "Status of every domain, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "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: -{
-  "billable_count": {},
-  "code": {},
-  "cold": {
-    "description": "hot-buyers: domains below the threshold, free."
-  },
-  "expires_at": {},
-  "next": {},
-  "price_micro_usd": {},
-  "price_usd": {},
-  "quote_id": {},
-  "results": {
-    "description": "Paid rows, after step 2."
-  },
-  "sandbox": {},
-  "status": {
-    "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results."
-  },
-  "statuses": {
-    "description": "Status of every domain, free."
-  }
-}
  3. Changed3 schema fields changed
    • removedOutput schema / anyOf
      Removed value: -[
-  {
-    "properties": {
-      "billable_count": {
-        "type": "integer"
-      },
-      "cold": {
-        "description": "hot-buyers: domains below the threshold, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "expires_at": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "next": {
-        "type": "string"
-      },
-      "price_micro_usd": {
-        "type": "integer"
-      },
-      "price_usd": {
-        "type": "number"
-      },
-      "quote_id": {
-        "type": "string"
-      },
-      "results": {
-        "description": "Paid rows, after step 2.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "sandbox": {
-        "additionalProperties": false,
-        "properties": {
-          "demo_domain": {
-            "const": true,
-            "type": "boolean"
-          },
-          "note": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "demo_domain",
-          "note"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
-        "enum": [
-          "quote",
-          "nothing_billable",
-          "ok"
-        ],
-        "type": "string"
-      },
-      "statuses": {
-        "description": "Status of every domain, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "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: +{
+  "billable_count": {},
+  "code": {},
+  "cold": {
+    "description": "hot-buyers: domains below the threshold, free."
+  },
+  "expires_at": {},
+  "next": {},
+  "price_micro_usd": {},
+  "price_usd": {},
+  "quote_id": {},
+  "results": {
+    "description": "Paid rows, after step 2."
+  },
+  "sandbox": {},
+  "status": {
+    "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results."
+  },
+  "statuses": {
+    "description": "Status of every domain, free."
+  }
+}
  4. Changed3 schema fields changed
    • removedInput schema / allOf
      Removed value: -[
-  {
-    "if": {
-      "properties": {
-        "tool": {
-          "const": "company-profile"
-        }
-      },
-      "required": [
-        "tool"
-      ]
-    },
-    "then": {
-      "properties": {
-        "domains": {
-          "maxItems": 33
-        }
-      }
-    }
-  }
-]
    • addedInput schema / description
      Added value: +"Create a quote with tool and domains (1–50; at most33 for company-profile), OR redeem with quote_id and neither tool nor domains. These mutually exclusive modes are validated by the server."
    • removedInput schema / oneOf
      Removed value: -[
-  {
-    "not": {
-      "required": [
-        "quote_id"
-      ]
-    },
-    "required": [
-      "tool",
-      "domains"
-    ]
-  },
-  {
-    "not": {
-      "anyOf": [
-        {
-          "required": [
-            "tool"
-          ]
-        },
-        {
-          "required": [
-            "domains"
-          ]
-        }
-      ]
-    },
-    "required": [
-      "quote_id"
-    ]
-  }
-]
  5. Changed5 schema fields changed
    • addedInput schema / allOf
      Added value: +[
+  {
+    "if": {
+      "properties": {
+        "tool": {
+          "const": "company-profile"
+        }
+      },
+      "required": [
+        "tool"
+      ]
+    },
+    "then": {
+      "properties": {
+        "domains": {
+          "maxItems": 33
+        }
+      }
+    }
+  }
+]
    • removedInput schema / anyOf
      Removed value: -[
-  {
-    "required": [
-      "tool",
-      "domains"
-    ]
-  },
-  {
-    "required": [
-      "quote_id"
-    ]
-  }
-]
    • addedInput schema / oneOf
      Added value: +[
+  {
+    "not": {
+      "required": [
+        "quote_id"
+      ]
+    },
+    "required": [
+      "tool",
+      "domains"
+    ]
+  },
+  {
+    "not": {
+      "anyOf": [
+        {
+          "required": [
+            "tool"
+          ]
+        },
+        {
+          "required": [
+            "domains"
+          ]
+        }
+      ]
+    },
+    "required": [
+      "quote_id"
+    ]
+  }
+]
    • addedInput schema / properties / quote_id / pattern
      Added value: +"^q_[a-f0-9]{32}$"
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "billable_count": {
-        "type": "integer"
-      },
-      "cold": {
-        "description": "hot-buyers: domains below the threshold, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "expires_at": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "next": {
-        "type": "string"
-      },
-      "price_micro_usd": {
-        "type": "integer"
-      },
-      "price_usd": {
-        "type": "number"
-      },
-      "quote_id": {
-        "type": "string"
-      },
-      "results": {
-        "description": "Paid rows, after step 2.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
-        "enum": [
-          "quote",
-          "nothing_billable",
-          "ok"
-        ],
-        "type": "string"
-      },
-      "statuses": {
-        "description": "Status of every domain, free.",
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "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": {
+      "billable_count": {
+        "type": "integer"
+      },
+      "cold": {
+        "description": "hot-buyers: domains below the threshold, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "expires_at": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "next": {
+        "type": "string"
+      },
+      "price_micro_usd": {
+        "type": "integer"
+      },
+      "price_usd": {
+        "type": "number"
+      },
+      "quote_id": {
+        "type": "string"
+      },
+      "results": {
+        "description": "Paid rows, after step 2.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "sandbox": {
+        "additionalProperties": false,
+        "properties": {
+          "demo_domain": {
+            "const": true,
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "demo_domain",
+          "note"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
+        "enum": [
+          "quote",
+          "nothing_billable",
+          "ok"
+        ],
+        "type": "string"
+      },
+      "statuses": {
+        "description": "Status of every domain, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "code": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "status": {
+        "maximum": 599,
+        "minimum": 400,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "status",
+      "code"
+    ],
+    "type": "object"
+  }
+]
  6. Changed1 schema field changed
    • addedInput schema / properties / context
      Added value: +{
+  "description": "Optional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.",
+  "type": "string"
+}
  7. Changed3 schema fields changed
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "properties": {
+      "billable_count": {
+        "type": "integer"
+      },
+      "cold": {
+        "description": "hot-buyers: domains below the threshold, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "expires_at": {
+        "format": "date-time",
+        "type": "string"
+      },
+      "next": {
+        "type": "string"
+      },
+      "price_micro_usd": {
+        "type": "integer"
+      },
+      "price_usd": {
+        "type": "number"
+      },
+      "quote_id": {
+        "type": "string"
+      },
+      "results": {
+        "description": "Paid rows, after step 2.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
+        "enum": [
+          "quote",
+          "nothing_billable",
+          "ok"
+        ],
+        "type": "string"
+      },
+      "statuses": {
+        "description": "Status of every domain, free.",
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "code": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "status": {
+        "maximum": 599,
+        "minimum": 400,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "status",
+      "code"
+    ],
+    "type": "object"
+  }
+]
    • removedOutput schema / properties
      Removed value: -{
-  "billable_count": {
-    "type": "integer"
-  },
-  "cold": {
-    "description": "hot-buyers: domains below the threshold, free.",
-    "items": {
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "expires_at": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "next": {
-    "type": "string"
-  },
-  "price_micro_usd": {
-    "type": "integer"
-  },
-  "price_usd": {
-    "type": "number"
-  },
-  "quote_id": {
-    "type": "string"
-  },
-  "results": {
-    "description": "Paid rows, after step 2.",
-    "items": {
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "status": {
-    "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
-    "enum": [
-      "quote",
-      "nothing_billable",
-      "ok"
-    ],
-    "type": "string"
-  },
-  "statuses": {
-    "description": "Status of every domain, free.",
-    "items": {
-      "type": "object"
-    },
-    "type": "array"
-  }
-}
    • removedOutput schema / required
      Removed value: -[
-  "status"
-]
  8. Changed1 schema field changed
    • addedInput schema / properties / tool / description
      Added value: +"Data tool to run for each domain during quote creation; omit when redeeming a quote_id."
  9. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "billable_count": {
+      "type": "integer"
+    },
+    "cold": {
+      "description": "hot-buyers: domains below the threshold, free.",
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "expires_at": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "next": {
+      "type": "string"
+    },
+    "price_micro_usd": {
+      "type": "integer"
+    },
+    "price_usd": {
+      "type": "number"
+    },
+    "quote_id": {
+      "type": "string"
+    },
+    "results": {
+      "description": "Paid rows, after step 2.",
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "status": {
+      "description": "quote: pay with quote_id to get the results. nothing_billable: no charge. ok: paid results.",
+      "enum": [
+        "quote",
+        "nothing_billable",
+        "ok"
+      ],
+      "type": "string"
+    },
+    "statuses": {
+      "description": "Status of every domain, free.",
+      "items": {
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "status"
+  ],
+  "type": "object"
+}
  10. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Adds substantive context beyond the readOnly/openWorld annotations: the scan is free, priced only on rows with data, empty rows are free, and capped at $1.00 per call. The statement that a quote does not authorize payment clarifies that redemption is the charge step, though the description never spells out that redemption itself incurs the price or what happens if a quote expires.

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?

Front-loaded with the core capability, then pricing, then usage routing — every sentence carries information. The pricing sentence is slightly dense with semicolons, but no filler is present.

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

Completeness4/5

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

Covers the two modes, cost model, per-row data options, and the single-domain alternative, and an output schema exists so return shape need not be explained. The only remaining gap is what redemption does to the caller's billing, which matters for a tool whose annotations mark it readOnly.

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 coverage is 100% and the enum, domain format, and quote_id pattern are already fully documented. The description contributes only the "up to 50 domains" ceiling and a value-prop restatement of the enum options; with the schema doing the heavy lifting, baseline 3 is appropriate.

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

Purpose5/5

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

States a specific verb, resource and scope: batch enrichment for up to 50 domains, with per-row data options enumerated. It explicitly distinguishes itself from the single-domain sibling get_company_profile, so an agent can route without opening either schema.

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

Usage Guidelines4/5

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

"Use when an agent enriches a prospect list" plus "One domain: get_company_profile" gives a clear trigger and names the alternative for the excluded case. It stops short of telling the agent when to redeem an existing quote_id versus create a new one, leaving that to the mutual-exclusion note in the schema.

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

All HirePulse Company Research toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources