# EmberReads Romance Books

Search 8,000+ romance books by trope, spice level, and content warnings. Powered by community-rated data from https://www.emberreads.app.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add emberreads/romance-books

# Browse available tools
npx -y @smithery/cli@latest tool list emberreads/romance-books

# Get full schema for a tool
npx -y @smithery/cli@latest tool get emberreads/romance-books search_romance_books

# Call a tool
npx -y @smithery/cli@latest tool call emberreads/romance-books search_romance_books '{}'
```

## Direct MCP Connection

Endpoint: `https://romance-books--emberreads.run.tools`

**Optional config:**
- `max_results` (query) — Default maximum results per search (1-20)
- `default_spice_min` (query) — Default minimum spice level (1-5)
- `default_spice_max` (query) — Default maximum spice level (1-5)

## Tools (4)

- `search_romance_books` — Search EmberReads' database of 8,000+ romance books. Filter by trope tags (enemies-to-lovers, grumpy-sunshine, dark-rom…
- `get_book_details` — Get full details for a specific romance book from EmberReads, including spice rating, trope tags, content warnings, and…
- `list_tropes` — List all 85+ romance tropes available on EmberReads, organized by category (relationship, character, setting, plot, ton…
- `get_trending_books` — Get currently trending romance books on EmberReads based on community activity and social media signals.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get emberreads/romance-books <tool-name>
```

## Resources

- `emberreads://tropes` — All 85+ romance tropes available on EmberReads
- `emberreads://trending` — Currently trending romance books on EmberReads

## Prompts (1)

- `recommend_romance` (tropes, spice, avoid) — Get personalized romance book recommendations based on tropes and spice preferences