Connect any AI to Operator's knowledge base.
The Operator MCP server gives AI agents structured access to 35M+ business profiles, health scores, trade problem playbooks, software replace guides, starter guides, cost audits, and trade vocabulary.
{
"mcpServers": {
"operator": {
"url": "https://operator.fyi/api/mcp-v2",
"transport": "http",
"headers": {
"X-Operator-Key": "your_key_here"
}
}
}
}GET https://operator.fyi/api/mcp-v2
Authentication
All POST requests require an X-Operator-Key header. Free tier: 1,000 requests per day. Get a free key at operator.fyi/app/settings/api-keys.
POST https://operator.fyi/api/mcp-v2
X-Operator-Key: op_your_key_here
Content-Type: application/json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_problem_articles",
"arguments": { "trade": "hvac" }
},
"id": 1
}Business data
search_businessSearch local businesses by keyword, category, and geography. Returns up to 25 results ranked by quality score. No PII.
| Param | Type | Required | Description |
|---|---|---|---|
query | string | optional | Business name or keyword |
category | string | optional | Category, e.g. "Plumber" or "HVAC" |
geo.city | string | optional | City name |
geo.state | string | optional | Two-letter state code, e.g. "HI" |
limit | integer | optional | Max results (1-25), default 25 |
get_business_scoreGet the Health Score (0-100) for a specific business, including six component bands: Revenue Velocity, Google Visibility, Pipeline Health, Cost Efficiency, Competitive Position, and Operator Coverage.
| Param | Type | Required | Description |
|---|---|---|---|
business_id | string | required | Business UUID from search results |
get_score_historyGet daily health score snapshots for a business over the past 1-90 days.
| Param | Type | Required | Description |
|---|---|---|---|
business_id | string | required | Business UUID |
days | integer | optional | Days of history (1-90), default 30 |
search_by_categoryPaginated search of businesses by category within a US state. Useful for market research and competitor discovery.
| Param | Type | Required | Description |
|---|---|---|---|
category | string | required | Business category |
state | string | optional | Two-letter state code |
limit | integer | optional | Max results (1-50), default 20 |
min_quality | integer | optional | Minimum quality score (0-100) |
Practices
get_trade_practicesGet installable practice recipes for a trade. Returns practices ranked by level, with manual method and Operator automation path.
| Param | Type | Required | Description |
|---|---|---|---|
trade_slug | string | required | Trade slug, e.g. "hvac", "plumbing", "dental" |
level | integer | optional | Filter by level (1-5) |
status | string | optional | Filter by status: approved, install_ready, draft |
Knowledge base
get_problem_articlesGet trade-specific problem playbooks. Each article covers: the dollar impact, manual fix steps, Operator automation path, customer phrases, and FAQ. Pass trade + problem_slug for full detail, or just trade for a list.
| Param | Type | Required | Description |
|---|---|---|---|
trade | string | optional | Trade slug, e.g. "hvac", "dental". Omit to see all available trades. |
problem_slug | string | optional | Problem slug, e.g. "missed_calls". Combine with trade for full article. |
limit | integer | optional | Max results (1-50), default 20 |
get_replace_guidesGet software replace guides. Each guide explains what Operator automates around an incumbent system (ServiceTitan, Jobber, Open Dental, etc.) vs. what stays in the system of record.
| Param | Type | Required | Description |
|---|---|---|---|
trade | string | optional | Trade slug filter, e.g. "dental", "hvac" |
saas | string | optional | Software slug filter, e.g. "servicetitan", "jobber", "open-dental" |
get_starter_guideGet the recommended starting point for a trade with AI agents. Covers the highest-ROI first automations, what to avoid, the manual baseline, and FAQ.
| Param | Type | Required | Description |
|---|---|---|---|
trade | string | optional | Trade slug, e.g. "dental", "hvac", "plumbing". Omit to list all available trades. |
get_cost_auditGet common overspend areas and monthly revenue recovery potential for a trade, with the Operator automation path for each leakage category.
| Param | Type | Required | Description |
|---|---|---|---|
trade | string | required | Trade slug, e.g. "dental", "hvac", "plumbing" |
get_trade_vocabularyGet trade-specific terminology: how customers describe problems, how operators talk about solutions, and the software context common in that trade. Useful for writing trade-appropriate copy or training AI agents.
| Param | Type | Required | Description |
|---|---|---|---|
trade | string | required | Trade slug, e.g. "hvac", "dental", "plumbing" |
limit | integer | optional | Number of problems to pull vocabulary from (1-20), default 10 |
// "What problems should an HVAC company fix first?"
{ "name": "get_problem_articles", "arguments": { "trade": "hvac" } }
// "What does Operator replace around ServiceTitan?"
{ "name": "get_replace_guides", "arguments": { "saas": "servicetitan" } }
// "Where should an HVAC company start with AI?"
{ "name": "get_starter_guide", "arguments": { "trade": "hvac" } }
// "How much revenue is an HVAC company leaking?"
{ "name": "get_cost_audit", "arguments": { "trade": "hvac" } }
// "How do HVAC customers describe their problems?"
{ "name": "get_trade_vocabulary", "arguments": { "trade": "hvac" } }