# AgentUtility Match Score

> AgentUtility Match Score is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Computes a 0–100 fuzzy similarity score between two values of a specified type (company, name, address, email, phone, or text) using blended Jaro-Winkler, token overlap, and match-key equality.

## Facts

- Endpoint: POST https://x402.agentutility.ai/match-score
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-match-score-a76850a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Dkyf8zAO7IQWXaJWFENM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentutility-match-score-a76850a2 -d '<json body>'
```

Example prompt: Can you score how similar 'Acme Corp.' and 'Acme Corporation' are as company names and tell me whether they share a match key?

## When to prefer this

Choose this endpoint when you need a fast, deterministic, single-pair similarity score without any external API calls or ML model latency. Ideal as the ranking step after bucketing candidates by match key — first cluster records using a match-key endpoint, then score pairs within each bucket using this endpoint. Prefer it over embedding-based similarity when you need reproducible, rule-based scores for auditability, or when processing high volumes at low cost ($0.003/call).

## Known failure modes

- Unsupported entity type provided — endpoint only accepts: company, name, address, email, phone, text
- Missing one or both values in the request body
- Payment not provided or insufficient USDC — x402 payment required
- Malformed JSON in request body
- Score may be low for highly abbreviated vs. fully spelled-out values despite semantic equivalence

## How this service works

Scores how similar two values are on a 0-100 scale for fuzzy matching and dedup confidence. Compares two values of a given type (company, name, address, email, phone, or text), blending match-key equality, Jaro-Winkler, and token overlap, and reports whether they share a match key. The companion to the match-key endpoints: bucket by key, then rank candidates by score. Deterministic and instant — no external lookups. Use it as a fuzzy match score, string similarity, or record-pair scoring API.

## Output

Returns a numeric similarity score from 0 to 100 (higher = more similar), a boolean or flag indicating whether the two values share a match key, and optionally a confidence label. The result is deterministic and computed locally without external lookups.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "a": {
       "type": "string",
       "description": "First value."
      },
      "b": {
       "type": "string",
       "description": "Second value."
      },
      "type": {
       "type": "string",
       "enum": [
        "company",
        "name",
        "address",
        "email",
        "phone",
        "text"
       ],
       "description": "Value type. Default 'text'."
      }
     },
     "required": [
      "a",
      "b"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "a": {
       "type": "string"
      },
      "b": {
       "type": "string"
      },
      "type": {
       "type": "string"
      },
      "score": {
       "type": "integer"
      },
      "same_key": {
       "type": "boolean"
      },
      "normalized_a": {
       "type": "string"
      },
      "normalized_b": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "a": "Acme Inc",
  "b": "Acme Incorporated",
  "type": "company",
  "score": 100,
  "same_key": true,
  "normalized_a": "acme",
  "normalized_b": "acme"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-match-score-a76850a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)