Selloracle Mcp

SellOracle MCP Server

Pre-computed Etsy market data for AI agents — real Blue Ocean niche scores, demand & competition signals, best sellers, and top shops, served over one remote MCP server and a REST API.

Stop letting your agent make up Etsy numbers. SellOracle aggregates 45K+ listings into niche-level conclusions (a 0–100 Blue Ocean score per keyword, computed weekly from four signals: demand, saturation, concentration, freshness) so your agent gets the answer in one call instead of scraping and re-deriving.

• 🌐 Website: https://selloracle.com
• 📚 Docs: https://selloracle.com/docs
• 🧰 Tool catalog: https://selloracle.com/tools
• 📈 Status & changelog: https://selloracle.com/status
• 🤖 llms.txt: https://selloracle.com/llms.txt

> This repository documents the hosted remote server (no local install needed). The server itself is closed-source.

Quick connect (MCP)

Get a free API key at https://selloracle.com/dashboard (no card), then add a remote connector.

Claude (claude.ai / Claude Desktop → Settings → Connectors → Add custom connector):

https://selloracle.com/mcp?key=so_live_YOUR_KEY

Cursor / generic MCP config:

{
  "mcpServers": {
    "selloracle": {
      "url": "https://selloracle.com/mcp",
      "headers": { "Authorization": "Bearer so_live_YOUR_KEY" }
    }
  }
}

Then just ask your agent: “Score the niche ‘minimalist wedding invitation’ on Etsy.”

• Transport: Streamable HTTP (single POST request/response), protocol 2025-06-18
• initialize / tools/list are open for discovery; tools/call requires the key

Tools (8)

| Tool | Tier | Credits | What it returns | |---|---|---|---| | get_niche_score | Data | 1 | Blue Ocean Score (0–100) for one keyword + the four underlying signals, avg price, views, favorites, shop count | | get_niche_report | Data | 2 | Multi-section niche report: verdict, demand/competition read, price band, top shops, recommended angle | | find_blue_ocean | Data | 1 | Low-competition, high-demand niches in a category, ranked by Blue Ocean Score | | search_keywords | Data | 1 | Keyword lookup with cached stats (total results, avg price, score) | | get_best_sellers | Data | 1 | Top-selling listings in a category | | get_top_shops | Data | 1 | Leading shops in a category with sales/review stats | | profit_calculator | Data | 1 | Full Etsy fee breakdown + net profit for a sale | | ai_reply_writer | AI | 10 | Drafts a customer-service reply in the seller's voice |

Every data response carries a dataAsOf field so you can verify freshness programmatically.

REST (same backend, same key)

curl "https://selloracle.com/api/v1/niche/score?keyword=minimalist+wedding+invitation" \
  -H "Authorization: Bearer so_live_YOUR_KEY"
# → { "success": true, "data": { "blueOceanScore": 72, "level": "blue", ... } }

Full endpoint list: https://selloracle.com/tools

Pricing

• Free — 100 data calls/day, no card
• Starter $19/mo — 10,000 credits (data ~1cr, AI ~10cr)
• Pro $49/mo — 50,000 credits
• Scale $199/mo — 300,000 credits

Try it without a key in the browser playground: https://selloracle.com/playground

Notes

• Data coverage: 14K+ scored niches (all categories + a digital-products segment), 1,400+ shops, refreshed weekly.
• SellOracle surfaces derived, aggregated signals computed from publicly available data — it does not proxy or resell access to Etsy's API.
• Independent project, not affiliated with, endorsed by, or sponsored by Etsy, Inc.

Support

hello@selloracle.com · https://selloracle.com/status

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: simonlin1212
• Source: simonlin1212/selloracle-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.