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. Send an Idempotency-Key header to make retries safe.

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.8/5.0

Behavior4/5

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

The description adds meaningful behavioral context beyond the annotations: '0.5 credits per returned organization', 'limit 0 returns only totalCount, free', and the Idempotency-Key retry guidance. These are useful operational details that the annotations do not provide, and nothing in the description contradicts the annotations.

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, each earning its place: purpose, cost behavior, and retry safety. The most important operational constraint (credit cost) is front-loaded immediately after the purpose.

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?

Despite having 18 parameters, the schema documents all of them and an output schema exists, so the description only needs to cover cross-cutting concerns. It covers cost, the free count mode, and retry safety, making it complete enough for an agent to call the tool correctly.

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 and the description does not need to re-document parameters. It adds only a cost-related note tied to the limit parameter, which is helpful but does not materially expand on the schema's already rich parameter descriptions.

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 clearly names the resource ('organizations') and the primary verb ('Search'), and adds a second distinct mode ('look them up by domain'). It is specific enough for an agent to understand what the tool does, though it does not explicitly differentiate itself from siblings like organizations_enrich or businesses_search.

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 description implies when to use the tool ('Search organizations, or look them up by domain') and gives context for the domain-lookup path. However, it does not name alternative tools or state when to choose one sibling over another, so the guidance is clear but not explicit.

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?