Crawlora MCP

Official

Overview Schema Source Related Servers Discussions Admin

bbb_search

Search Better Business Bureau businesses by name or category near a location to get BBB ratings, accreditation status, contact info, categories, and profile URLs.

Instructions

Search Better Business Bureau businesses. Searches bbb.org for businesses by name or category near a location. Returns each business's BBB rating letter grade, accreditation status, categories, service areas, contact info, and profile URL. A verified empty first page returns results: [] and total_results: 0; an unavailable or unrecognized page returns an error. A page beyond the exact last page returns 404, and a page beyond BBB's 15-page accessible limit returns 404 naming that limit. Category IDs and state/province codes are query-scoped; call bbb-search-filters to discover values for this query and location.

Input Schema

Name	Required	Description
`page`	No	Result page, default 1
`sort`	No	Sort order
`query`	Yes	Business name or category/service keyword
`state`	No	Query-scoped state or province code from bbb-search-filters
`rating`	No	One or more BBB rating buckets
`country`	No	BBB country code
`distance`	No	Maximum distance in miles; omit for all distances
`location`	Yes	City and state (e.g. 'Austin, TX') or a ZIP code
`get_quote`	No	Only businesses offering quote requests
`accredited`	No	Only BBB-accredited businesses
`category_id`	No	Query-scoped category ID from bbb-search-filters
`service_area`	No	Only businesses serving the searched area

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedv1.17.12Oct 13, 2026

addedInput schema / properties / accredited

Added value: +{
+  "description": "Only BBB-accredited businesses",
+  "type": "boolean"
+}

addedInput schema / properties / category_id

Added value: +{
+  "description": "Query-scoped category ID from bbb-search-filters",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / country

Added value: +{
+  "description": "BBB country code",
+  "enum": [
+    "USA",
+    "CAN"
+  ],
+  "type": "string"
+}

addedInput schema / properties / distance

Added value: +{
+  "description": "Maximum distance in miles; omit for all distances",
+  "enum": [
+    "5",
+    "10",
+    "25",
+    "50",
+    "100"
+  ],
+  "type": "string"
+}

addedInput schema / properties / get_quote

Added value: +{
+  "description": "Only businesses offering quote requests",
+  "type": "boolean"
+}

addedInput schema / properties / rating

Added value: +{
+  "description": "One or more BBB rating buckets",
+  "items": {
+    "enum": [
+      "A",
+      "B",
+      "C",
+      "D",
+      "F"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / service_area

Added value: +{
+  "description": "Only businesses serving the searched area",
+  "type": "boolean"
+}

addedInput schema / properties / sort

Added value: +{
+  "description": "Sort order",
+  "enum": [
+    "Relevance",
+    "Distance",
+    "Rating",
+    "AToZ",
+    "ZToA"
+  ],
+  "type": "string"
+}

addedInput schema / properties / state

Added value: +{
+  "description": "Query-scoped state or province code from bbb-search-filters",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Addedv1.16.0Aug 29, 2026

TDQS

A4.4/5.0

Behavior5/5

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

With no annotations, the description carries the full burden and does so well: it discloses empty-result semantics (results: [] and total_results: 0), error behavior for unavailable/unrecognized pages, 404 for pages past the exact last page, and a hard 15-page accessible limit. This is unusually rich operational context that an agent cannot infer from the schema.

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?

Purpose and scope are front-loaded in the first two sentences, then return fields, then edge cases. The pagination/error sentences are somewhat dense but each conveys distinct behavior, so there is little wasted text.

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?

No output schema exists, so the description must describe returns, and it does (rating, accreditation, categories, service areas, contact info, profile URL) plus empty-result and error/pagination semantics. Nothing critical for correct invocation is missing.

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 schema descriptions already mark category_id and state as 'Query-scoped ... from bbb-search-filters'. The description reinforces that query-scoping but adds little formatting or semantic detail beyond what the schema already carries, so the baseline 3 applies.

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 (Search) and resource (Better Business Bureau businesses) with scope qualification (by name or category near a location), and enumerates the returned fields (rating letter grade, accreditation, categories, service areas, contact info, profile URL). An agent can immediately tell this is the BBB directory search endpoint rather than a BBB detail or category endpoint.

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?

Explicitly routes the agent to a companion tool: category IDs and state/province codes are query-scoped, so call bbb-search-filters to discover values for this query and location. It does not, however, state when NOT to use this tool versus bbb_business or bbb_category siblings, so the guidance is clear but not exhaustive.

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

Deploy Server

bbb_search

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools