---
title: "Grade listing quality"
method: GET
path: "/api/mcp/listing/{slug}/grade"
tags: ["MCP API"]
---

# Grade listing quality

`GET /api/mcp/listing/{slug}/grade`

## Request

- Base URL: `https://www.cyclesite.co.uk`
- URL: `https://www.cyclesite.co.uk/api/mcp/listing/{slug}/grade`
- Auth: none required

Categorical quality grade (excellent/good/fair/weak) plus up to two strengths and two improvement flags, and a market price verdict (below_market/fair/above_market). The numeric score, the % price delta and the AI-suggested price are deliberately NOT returned — only the categorical verdict — to protect the grading rubric and valuation model. No authentication required.

## Path parameters

- `slug` string, required: Listing URL slug

## Response `200`

Listing grade

- object
  - `attribution` string, required
  - `flags` string[], required
  - `grade` 'excellent' | 'good' | 'fair' | 'weak', required
  - `listing` object, required
    - `brand` string, nullable, required
    - `model` string, nullable, required
    - `priceGbp` number, required
  - `priceVerdict` 'below_market' | 'fair' | 'above_market', nullable, required
  - `url` string, required
  - `wins` string[], required

## Other responses

- `400`: Invalid slug
- `404`: Listing not found
- `429`: Rate limited

---

[API](https://skmtc.dev/cyclesite/apis/cyclesite-public-api.md) · [All operations](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cyclesite/apis/cyclesite-public-api/revisions/a0dc604cce71?raw)