# Scoring models

> Score every new lead against your ideal customer with rules for company, location, pages visited and more.

Every section below does the same job: in the dashboard (Guide), from your code (API) or through an AI assistant (MCP).

## Guide — In the dashboard

Source: /docs/qualify/scoring-models

A scoring model is your definition of a good lead: rules for company size, industry, location, pages visited, job title and more, each with a weight. Every new lead gets a score from it.

<DemoFrame guide="qualify-scoring-models" to="/score-model/{workspace}" />

1. **Qualify → open a model.**
2. **Add or change rules** and their weight (Penalize … Very important).
3. **Test a website** to see how any company would score, then **Save and Close**.

### Every control on this screen [#every-control-on-this-screen]

Every button, field and switch, with what it does.

<ScreenControls screens={["qualify", "qualify-editor", "qualify-new-model", "qualify-delete-model", "qualify-test-website", "qualify-score-bands"]} />


---

## API — From your code

Source: /docs/qualify/scoring-models/api

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["GET /admin/lead-scoring", "POST /admin/lead-scoring", "GET /admin/lead-scoring/{id}", "PUT /v3/lead-scoring/{modelId}", "DELETE /admin/lead-scoring/{id}"]} />

<ApiPlayground
  ops={["GET /admin/lead-scoring", "POST /admin/lead-scoring", "GET /admin/lead-scoring/{id}", "PUT /v3/lead-scoring/{modelId}", "DELETE /admin/lead-scoring/{id}"]}
  method="get"
  path="/admin/lead-scoring"
  tool="list_lead_scoring_models"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}`}
/>

### Use case: Read a model’s rules [#use-case-read-a-models-rules]

`GET /admin/lead-scoring/{id}` returns its criteria; change them with `PUT /v3/lead-scoring/{modelId}` — each criterion you send replaces that criterion’s rules.


---

## MCP — AI agents

Source: /docs/qualify/scoring-models/mcp

Connect the [MCP server](/docs/mcp#quickstart), then just ask.

<Tools names={["list_lead_scoring_models", "get_lead_scoring_model", "create_lead_scoring_model", "update_lead_scoring_model", "delete_lead_scoring_model"]} />

### Use case [#use-case]

> Show me how my default scoring model works.

<McpToolCall name="list_lead_scoring_models">

```json
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}
```

</McpToolCall>