find-service-providers

# find-service-providers Drive the **ServiceGraph API** (`https://api.servicegraph.co`) to find, shortlist, and enrich US professional-services firms. The API hosts several **datasets** behind a uniform per-dataset URL shape (`/v1/datasets/:id/…`). This skill is for the agencies dataset — **dataset id `pro_services`** — which holds 100k+ B2B service firms classified across 22 industries with multi-tag service taxonomies, location, size, and third-party rating signals. Any HTTP client works (curl, fetch, requests). Examples below use curl. ## MCP server (preferred for authed calls) If your agent harness has the **ServiceGraph MCP server** loaded (`https://mcp.servicegraph.co`) — recognizable by tool names containing `servicegraph` — prefer those tools over raw HTTP. The MCP server uses OAuth 2.1 + PKCE so the harness handles credentials in its own sandbox and no token value ever enters the LLM context. Otherwise, fall through to the REST flow described below. ## API surface Every endpoint requires the bearer (`Authorization: Bearer vk_…`). There is no anonymous tier. | Endpoint | Cost | Use it for | |---|---|---| | `GET /v1/datasets` | free | Discover available datasets. | | `GET /v1/datasets/pro_services` | free | Full schema for this dataset (brief vs detail fields, allowed filters, unlock price, TTL). | | `GET /v1/datasets/pro_services/fields[?include_values=1&q=]` | free | Filter-field catalog + DSL grammar. Call this first per session. | | `GET /v1/datasets/pro_se...