# Selloracle Mcp

> Pre-computed Etsy market data for AI agents — remote MCP server + REST API. Blue Ocean niche scores, demand/competition signals, best sellers, top shops. Free tier, no card.

- **Type:** MCP server
- **Install:** `agentstack add mcp-simonlin1212-selloracle-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [simonlin1212](https://agentstack.voostack.com/s/simonlin1212)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.1.0
- **License:** MIT
- **Upstream author:** [simonlin1212](https://github.com/simonlin1212)
- **Source:** https://github.com/simonlin1212/selloracle-mcp

## Install

```sh
agentstack add mcp-simonlin1212-selloracle-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:**

```json
{
  "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)

```bash
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](https://github.com/simonlin1212)
- **Source:** [simonlin1212/selloracle-mcp](https://github.com/simonlin1212/selloracle-mcp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-simonlin1212-selloracle-mcp
- Seller: https://agentstack.voostack.com/s/simonlin1212
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.