# update_lead_quality (/docs/mcp/tools/update-lead-quality)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/update_lead_quality.mdx. */}

**Update the lead quality bar** · Changes data

Changes the lead quality settings of a website. Leads scoring below the bar are not added (and use no credits). Only the fields you pass change; the highest bar is 80 (20 on lifetime-deal plans).

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites. |
| `minScore` | `number` | No | Minimum ideal-customer score for every source (0-80). |
| `bySource` | `object` | No | Per-source bars that override minScore. |
| `bySource.visitors` | `number` | No | Minimum score for website visitor leads (0-80); null uses the general bar. |
| `bySource.intent` | `number` | No | Minimum score for 3rd-party intent leads (0-80); null uses the general bar. |
| `bySource.scraping` | `number` | No | Minimum score for Web Scraping leads (0-80); null uses the general bar. |
| `bySource.prospector` | `number` | No | Minimum score for Prospector leads (0-80); null uses the general bar. |
| `bySource.scout` | `number` | No | Minimum score for AI Scout leads (0-80); null uses the general bar. |
| `contactsOnly` | `boolean` | No | Only keep leads with a person to contact. |
| `audienceFocus` | `"B2B" \| "B2C" \| "BOTH"` | No | B2B, B2C or BOTH. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "update_lead_quality",
  "title": "Update the lead quality bar",
  "annotations": {
    "title": "Update the lead quality bar",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "minScore": {
        "type": "number",
        "minimum": 0,
        "maximum": 80,
        "description": "Minimum ideal-customer score for every source (0-80)."
      },
      "bySource": {
        "type": "object",
        "properties": {
          "visitors": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for website visitor leads (0-80); null uses the general bar."
          },
          "intent": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for 3rd-party intent leads (0-80); null uses the general bar."
          },
          "scraping": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for Web Scraping leads (0-80); null uses the general bar."
          },
          "prospector": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for Prospector leads (0-80); null uses the general bar."
          },
          "scout": {
            "type": "number",
            "minimum": 0,
            "maximum": 80,
            "description": "Minimum score for AI Scout leads (0-80); null uses the general bar."
          }
        },
        "description": "Per-source bars that override minScore."
      },
      "contactsOnly": {
        "type": "boolean",
        "description": "Only keep leads with a person to contact."
      },
      "audienceFocus": {
        "type": "string",
        "enum": [
          "B2B",
          "B2C",
          "BOTH"
        ],
        "description": "B2B, B2C or BOTH."
      }
    },
    "required": [
      "websiteId"
    ]
  }
}
```
