ListingGood Developers

Make AI recommend your products — connect ListingGood's real backend (compliance knowledge base + generation engine + star billing) to any AI workspace that supports MCP or REST.

Get API Key → Connect in 1 minute

What you can build

ListingGood exposes two integration surfaces that share the same backend:

1 · MCP Connector (recommended)

A remote MCP server (streamable HTTP). Paste one URL with your API key into any MCP client — Claude Desktop, Cursor, WorkBuddy, or your own agent — and call 7 tools with zero local install.

2 · REST API

The same backend behind an OpenAPI-style REST interface. Authenticate with your API key and call endpoints directly from your own services, scripts, or backend jobs.

Both surfaces consume the same star-based billing. 1 star = $0.10. New accounts get 10 free compliance checks.

① Connection URL

Configure this URL in your MCP client and replace YOUR_KEY with your own ListingGood API key. No local install, no ops.

https://listinggood.com/mcp?apikey=YOUR_KEY

Need a key? Log in and copy it from the Get API Key section below — the config cards will auto-fill.

② My connector config (auto-filled after login)

③ Tool list (7)

ToolBackendBillingDescription
ai_readiness_check/api/free-checkFreeAI recommendation readiness check — compliance health + AI readability. Works without a key.
compliance_check/api/compliance-checkFreeQuick pre-generation compliance check (banned words / category risk).
compliance_scan/api/scan/deepDeep compliance scan, knowledge-base-driven risk report.
generate_poa/api/appeal/poaGenerate a submit-ready POA appeal letter.
analyze_review/api/appeal/reviewNegative-review root cause + response suggestions.
fill_from_sentence/api/fill-from-sentenceFreeTurn one sentence into structured form fields.
generate_listing/api/generateGenerate high-converting multi-marketplace listings.

Billing unit: 1 star = $0.10. New users get 10 free compliance checks in the permanent wallet. On insufficient balance the tool returns 402 asking to top up.

④ Connection example (Python)

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async with streamablehttp_client(
    "https://listinggood.com/mcp?apikey=YOUR_KEY") as (r, w, _):
    async with ClientSession(r, w) as s:
        await s.initialize()
        res = await s.call_tool("ai_readiness_check",
                                {"text": "wireless earbuds", "marketplace": "US"})
        print(res)

Vertical MCPs (category-specific lead-gen)

Beyond the general connector, we ship narrow vertical MCPs that catch sellers at the exact pain point — fear of takedown / non-compliance — inside their AI agent workflow, then route them to ListingGood to pay for the deliverable.

Electronics Compliance MCP

Free diagnostic for electronics / electrical (CE / EMC / RoHS / WEEE / GPSR / FCC). 3 free tools; the per-SKU compliance evidence file package is generated on the site (paid).

https://listinggood.com/mcp-electronics

No API key required — it's a free diagnostic front-end that returns a link to your paid /compliant file package.

API Reference (REST)

Authentication

Send your API key as a Bearer token in the request header, or as the apikey query parameter. The free hook /api/free-check requires no auth.

Authorization: Bearer YOUR_KEY
# or
GET /api/free-check?text=...&marketplace=US

Endpoints

MethodPathBillingDescription
POST/api/free-checkFreeAI readiness check. Body: {text, marketplace}.
POST/api/compliance-checkFreeQuick pre-check. Body: {title, bullets, marketplace}.
POST/api/scan/deepDeep scan. Body: {title, bullets, desc, marketplace, images?}.
POST/api/appeal/poaPOA letter. Body: {violation_type, marketplace, text}.
POST/api/appeal/reviewReview analysis. Body: {marketplace, review_text}.
POST/api/fill-from-sentenceFreeForm fill. Body: {sentence}.
POST/api/generateListing generation. Body: {cn_name, sku, marketplaces[], selling_points[]}.

Example request

curl -X POST https://listinggood.com/api/scan/deep \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"French wool beret","bullets":["..."],"marketplace":"US"}'

On success the endpoint returns a JSON task; poll GET /api/task/<id> for the result. On insufficient stars it returns 402 with the cost.

Get your API Key

Use this key to authenticate the MCP connector or REST API. It is tied to your account and star balance.

Enterprise bulk integration / private deployment: email support@listinggood.com.

Need help? Email support@listinggood.com. For enterprise bulk integration / private deployment, contact us.