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.
ListingGood exposes two integration surfaces that share the same backend:
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.
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 stars.
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
Get a key: after logging in to listinggood.com, visit /api/user/apikey — the connector config below auto-fills with your key.
| Tool | Backend | Billing | Description |
|---|---|---|---|
ai_readiness_check | /api/free-check | Free | AI recommendation readiness (compliance health + AI readability). The no-key acquisition hook. |
compliance_check | /api/compliance-check | Free | Quick pre-generation compliance check (red-line words / category risk). |
compliance_scan | /api/scan/deep | 3 stars | Deep compliance scan, knowledge-base-driven risk report. |
generate_poa | /api/appeal/poa | 10 stars | Generate a submit-ready POA appeal letter. |
analyze_review | /api/appeal/review | 3 stars | Negative-review root cause + response suggestions. |
fill_from_sentence | /api/fill-from-sentence | Free | Turn one sentence into structured form fields. |
generate_listing | /api/generate | 1 star / site | Generate high-converting multi-marketplace listings. |
Billing unit: 1 star = $0.10. New users get 10 free stars in the permanent wallet. On insufficient balance the tool returns 402 asking to top up.
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)
Send your API key as a Bearer token in the request header, or as the apikey query parameter. The no-key hook /api/free-check requires no auth.
Authorization: Bearer YOUR_KEY # or GET /api/free-check?text=...&marketplace=US
| Method | Path | Billing | Description |
|---|---|---|---|
POST | /api/free-check | Free | AI readiness check. Body: {text, marketplace}. |
POST | /api/compliance-check | Free | Quick pre-check. Body: {title, bullets, marketplace}. |
POST | /api/scan/deep | 3 stars | Deep scan. Body: {title, bullets, desc, marketplace, images?}. |
POST | /api/appeal/poa | 10 stars | POA letter. Body: {violation_type, marketplace, text}. |
POST | /api/appeal/review | 3 stars | Review analysis. Body: {marketplace, review_text}. |
POST | /api/fill-from-sentence | Free | Form fill. Body: {sentence}. |
POST | /api/generate | 1 star / site | Listing generation. Body: {cn_name, sku, marketplaces[], selling_points[]}. |
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.
Log in to listinggood.com, then open /api/user/apikey. The page shows your key and the connector config auto-fills above. Keep the key secret — it carries your 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.