Deeplead

Search organizations, or look them up by domain

organizations_search

Search organizations, or look them up by domain. Charges 0.5 credits per returned organization. limit 0 returns only totalCount, free.

Input Schema

TableJSON Schema

Name	Required	Description
`limit`	No	Maximum companies to return; 0 returns only a free count
`query`	No	Free text matched against company name, description and keywords
`hqCity`	No	City names of the headquarters, e.g. ["Austin"]
`offset`	No	Number of matching companies to skip for pagination
`domains`	No	Look companies up by domain, e.g. ["stripe.com"]
`hqState`	No	US state names or codes of the headquarters
`semantic`	No	What the company is and sells, matched by meaning, e.g. "outsourced medical billing for clinics"
`hqCountry`	No	ISO alpha-2 country codes of the headquarters, e.g. ["US", "DE"]
`fundedAfter`	No	Year of the last funding round, at least; known for about 1 in 100 US companies
`foundedAfter`	No	Earliest founding year to include
`revenueRange`	No	Annual company revenue bands
`technologies`	No	Technologies used by the company
`employeeBands`	No	Headcount bands
`foundedBefore`	No	Latest founding year to include
`monthlyVisitsMin`	No	Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded
`employeeGrowthMin`	No	Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies
`industryNaicsDirect`	No	NAICS codes
`includeWithoutWebsite`	No	Include companies without websites in search results

Output Schema

TableJSON Schema

Name	Required	Description	Default
`totalCount`	Yes
`organizations`	Yes
`chargedCredits`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed10 schema fields changedSep 26, 2026

addedInput schema / properties / foundedAfter / description
```
Added value: +"Earliest founding year to include"
```
addedInput schema / properties / foundedBefore / description
```
Added value: +"Latest founding year to include"
```

addedInput schema / properties / hqCity

Added value: +{
+  "description": "City names of the headquarters, e.g. [\"Austin\"]",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / includeWithoutWebsite / description

Added value: +"Include companies without websites in search results"

addedInput schema / properties / limit / description

Added value: +"Maximum companies to return; 0 returns only a free count"

changedInput schema / properties / limit / minimum
```
Previous value: -1New value: +0
```

addedInput schema / properties / offset / description

Added value: +"Number of matching companies to skip for pagination"

addedInput schema / properties / revenueRange / description
```
Added value: +"Annual company revenue bands"
```
addedInput schema / properties / technologies / description
```
Added value: +"Technologies used by the company"
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "chargedCredits": {
+      "type": "number"
+    },
+    "organizations": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "adPixels": {
+            "additionalProperties": false,
+            "description": "true/false where the website was checked, null where it never was",
+            "properties": {
+              "chatgpt": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "googleAds": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "googleAnalytics": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "meta": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "tiktok": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "meta",
+              "googleAds",
+              "googleAnalytics",
+              "tiktok",
+              "chatgpt"
+            ],
+            "type": "object"
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "domain": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "emails": {
+            "description": "Found on the company website",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "employeeCount": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "employeeGrowthRate": {
+            "description": "Employee growth on LinkedIn in percent",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "employeeMax": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "employeeMin": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "foundedYear": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "hqCity": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hqCountry": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hqState": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "industry": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "keywords": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "lastFunding": {
+            "additionalProperties": false,
+            "properties": {
+              "amount": {
+                "description": "USD",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "date": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "type": {
+                "description": "e.g. Seed Round, Series A, Private Equity Round",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "type",
+              "date",
+              "amount"
+            ],
+            "type": "object"
+          },
+          "linkedin": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "linkedinDescription": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "monthlyGoogleAdSpend": {
+            "description": "Estimated monthly Google Ads spend in USD",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "monthlyVisits": {
+            "description": "Estimated monthly website visits",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "naicsCodes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "organizationId": {
+            "type": "string"
+          },
+          "phones": {
+            "description": "Found on the company website",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "revenueRange": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "socials": {
+            "additionalProperties": false,
+            "properties": {
+              "facebook": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "instagram": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "linkedin": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "tiktok": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "x": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "youtube": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "facebook",
+              "instagram",
+              "linkedin",
+              "x",
+              "tiktok",
+              "youtube"
+            ],
+            "type": "object"
+          },
+          "technologies": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "totalFunding": {
+            "description": "USD",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "website": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "websiteAlive": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "websiteDescription": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "websiteTitle": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "organizationId",
+          "name",
+          "domain",
+          "website",
+          "websiteAlive",
+          "websiteTitle",
+          "websiteDescription",
+          "linkedin",
+          "linkedinDescription",
+          "description",
+          "industry",
+          "naicsCodes",
+          "keywords",
+          "technologies",
+          "employeeCount",
+          "employeeMin",
+          "employeeMax",
+          "revenueRange",
+          "monthlyVisits",
+          "monthlyGoogleAdSpend",
+          "employeeGrowthRate",
+          "lastFunding",
+          "totalFunding",
+          "foundedYear",
+          "hqCity",
+          "hqState",
+          "hqCountry",
+          "emails",
+          "phones",
+          "socials",
+          "adPixels"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "totalCount": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "totalCount",
+    "chargedCredits",
+    "organizations"
+  ],
+  "type": "object"
+}

First observedSep 25, 2026

TDQS

A3.7/5.0

Behavior4/5

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

Annotations declare readOnlyHint=false (unusual for a search tool) and the description supplies the missing context: the call consumes credits proportional to organizations returned. It also discloses the free count-only mode, which is real behavioral information not derivable from annotations or schema. It stops short of describing result ordering, pagination limits, or truncation behavior.

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

Conciseness5/5

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

Three short sentences with zero filler; the capability statement comes first and the cost/count caveat follows immediately. Nothing is padded or redundant.

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

Completeness3/5

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

An output schema exists and the schemas are fully documented, so the description needn't explain return values. For an 18-parameter search tool it is still thin: it never says how the filters combine (e.g. domains with query), nor whether pagination beyond offset 10000 is impossible. Adequate but with clear gaps.

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% and every parameter, including the limit=0 trick, is documented in the schema itself. The description adds no syntax or format detail beyond what the schema already provides, so the baseline 3 applies.

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?

States a specific verb (search/look up) and resource (organizations), and distinguishes two modes: text search versus domain lookup. It does not, however, name or contrast itself against obvious siblings such as organizations_enrich or organizations_find_decision_maker, so an agent must infer the boundary.

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?

The cost model (0.5 credits per returned organization) and the 'limit 0 returns only totalCount, free' tip imply a cost-aware usage pattern, which is genuinely useful guidance. However, there is no explicit statement of when to use this tool instead of organizations_enrich, organizations_find_decision_maker, or businesses_search.

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

All Deeplead tools Inspect

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

Need Help?