# ListingGood MCP

> Get recommended by Amazon's AI. Hosted MCP server for Amazon listing compliance & generation.

- name: io.github.ryanyang828/listinggood
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ryanyang828%2Flistinggood
- tools: https://api.protogrid.dev/v1/servers/io.github.ryanyang828%2Flistinggood/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "listinggood": {
      "type": "http",
      "url": "https://listinggood.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 99
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-98% ~updated-69d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: agent_ready_check (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); compliance_check (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); compliance_scan (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,152 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 2,152 tokens to load them all
- tool set hash: 0a7888e049bbd4a1a8a806ee5436d3c4
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ryanyang828/listinggood.svg)](https://protogrid.dev/servers/io.github.ryanyang828/listinggood)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://listinggood.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.98275864)

## Packages

_none_

## Tools (8)

- `agent_ready_check`: Score whether a product listing is Agent-Ready for AI shopping agents (ACP/UCP era).

    Platform-agnostic: works for Amazon, Shopify, Walmart, TikTok Shop or any storefront that
    AI shopping assistants may read. Use it when a user asks whether their product will be
    found, recommended, or auto-purchased by an AI agent.

    Fully local, deterministic rule engine — no API key, no credits, no network call. Returns
    four dimensions: structured attributes, entity clarity, trust & compliance, and agent
    actionability, plus ranked fixes.

    Args:
        text: raw product copy — title plus bullets/description (required).
        platform: amazon | shopify | walmart | tiktok | generic | auto (default auto-detected).
        lang: en or zh for the report language (default en).
- `ai_readiness_check`: Score how likely Amazon's AI (Rufus, COSMO) is to recommend a listing.

    Free, deterministic, rule-based check on pasted listing copy (title, bullets, description).
    Returns a compliance health score, an AI-readability score, and a combined AI Recommendation
    Readiness Score (compliance * 0.55 + readability * 0.45) with actionable suggestions.

    Use this as a fast baseline BEFORE generating or editing a listing. Do NOT use it for a full
    compliance report - use compliance_scan for the deep knowledge-base audit. Free, read-only,
    no API key required, no credits deducted.

    Args:
        text: raw listing title + bullets + description (required).
        marketplace: marketplace code, US/DE/ES/FR/IT/JP/AE/SA/UK (default US).
        lang: zh or en (default en).
        email: optional lead email for a confirmation message and lead capture.
- `analyze_review`: Analyze a negative Amazon review for root cause and a suggested response (async; 2 credits).

    Extracts the underlying issue from a critical review and drafts a brand-appropriate response
    angle. Use this after a negative review appears, to decide how to reply. Do NOT use it to
    generate a listing or an appeal - use generate_listing or generate_poa for those. Read-only;
    deducts 2 credits; runs asynchronously, poll for the result.

    Args:
        text: the negative review text (required).
        marketplace: marketplace code (default US).
        lang: zh or en (default en).
- `compliance_check`: Quick pre-publish compliance gate before generating a listing.

    Fast, free scan for obvious red-line words and category risks. Returns a shallow
    pass/fail-style result, not a full audit.

    Use this as a cheap pre-check right before generation. Do NOT use it for a complete risk
    report - use compliance_scan for the deep knowledge-base audit. Read-only; requires an API
    key; no credits deducted.

    Args:
        text: listing copy (required).
        lang: zh or en (default en).
        category: optional category hint, e.g. electronics or apparel.
- `compliance_scan`: Deep knowledge-base compliance audit (async; 2 credits).

    Produces a thorough, written risk report covering prohibited words, IP, category
    mismatches, GPSR and more, backed by a private 15-year compliance knowledge base.

    Use this when you need a complete, actionable compliance report. Do NOT use it for a quick
    pre-publish check - use compliance_check for that. Read-only; deducts 2 credits; runs
    asynchronously, poll for the result.

    Args:
        text: listing title/bullets/description (required).
        marketplace: marketplace code (default US).
        category: optional category hint.
        lang: zh or en (default en).
        images: optional list of up to 5 data:image base64 strings, each < 4MB.
- `fill_from_sentence`: Expand a one-sentence product description into structured listing fields (free; API key; no credits).

    Turns casual, spoken product copy into structured fields (title, bullets, features) that feed
    the listing generator. Use this as a low-friction starting point when you only have a rough
    sentence. Do NOT use it to produce a final optimized listing - use generate_listing for that.
    Read-only; free; no credits deducted.

    Args:
        sentence: one-sentence product description, 4-1000 characters (required).
        lang: zh or en (default en).
- `generate_listing`: Generate a high-conversion Amazon listing - title + bullets + description (async; 1 credit per marketplace).

    Produces A9-optimized copy that respects per-marketplace character limits. Use this to create
    a full listing from product facts. Not free - deducts 1 credit per selected marketplace and
    runs asynchronously, poll for the result. Read-only: it drafts text and does not publish.

    Args:
        cn_name: product Chinese name (required).
        sku: product SKU (required).
        marketplaces: optional list of marketplace codes; defaults to all 9.
        price: optional product price.
        lang: zh or en (default en).
- `generate_poa`: Draft a submission-ready Plan of Action (POA) from an Amazon violation notice (async; 4 credits).

    Converts a suspension or removal email into a structured POA appeal. Use this when a listing
    or account is suppressed. Not free - deducts 4 credits and runs asynchronously, poll for the
    result. Read-only: it drafts text and does not submit anything to Amazon.

    Args:
        text: violation notice or removal email text (required).
        marketplace: marketplace code (default US).
        lang: zh or en (default en).
        violation_type: optional, e.g. ip_complaint / authenticity / policy.
