# TrySellr MCP Server

**AI-powered selling intelligence for Facebook Marketplace, eBay, Mercari, OfferUp, and Craigslist.**

TrySellr plugs into any MCP-compatible AI assistant (Claude, ChatGPT, Cursor, etc.) and gives sellers superpowers: instant item analysis, conversion-optimized listings, cross-platform pricing data, negotiation coaching, demand intelligence, and batch processing.

> **One server. Every AI assistant. Every marketplace.**

---

## Tools

| Tool | What It Does | Tier |
|------|-------------|------|
| `analyze_item` | Identify items, estimate value, detect brand/model | Free (3/day) |
| `optimize_listing` | Generate high-converting listings with SEO | Free (3/day) |
| `price_check` | Cross-platform pricing with sell-speed estimates | Pro |
| `negotiate_assist` | AI negotiation coach with copy-paste replies | Pro |
| `demand_radar` | Trending items and demand signals by location | Pro |
| `performance_track` | Listing health score and optimization plan | Pro |
| `batch_list` | Process 2-25 items at once | Power |
| `cross_list` | Generate listings for 2-6 platforms simultaneously | Power |

---

## Pricing

- **Free**: 3 analyze + 3 optimize calls/day. No credit card.
- **Pro ($19/mo)**: All analysis, pricing, negotiation, and tracking tools.
- **Power Seller ($49/mo)**: Everything + batch processing + cross-listing.

---

## Quick Start

### 1. Get Your API Key

```bash
curl -X POST https://trysellr.com/api/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
```

### 2. Connect to Claude Desktop

Add to your Claude Desktop MCP config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "trysellr": {
      "url": "https://trysellr.com/mcp",
      "headers": {
        "x-trysellr-key": "tsk_your_api_key_here"
      }
    }
  }
}
```

### 3. Start Selling Smarter

Open Claude and say:
- *"Analyze this item: Sony WH-1000XM4 headphones, used, good condition, comes with case"*
- *"Write a Facebook Marketplace listing for a mid-century modern coffee table, walnut, 48x24, great condition"*
- *"What's trending in Electronics in Nashville right now?"*

---

## API Endpoint

**Base URL**: `https://trysellr.com/mcp`

**Transport**: Streamable HTTP (MCP spec 2025-03-26)

**Auth**: Header `x-trysellr-key: tsk_your_key`

### MCP Protocol

```bash
# Initialize
curl -X POST https://trysellr.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-trysellr-key: tsk_your_key" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

# List tools
curl -X POST https://trysellr.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'

# Call a tool
curl -X POST https://trysellr.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-trysellr-key: tsk_your_key" \
  -d '{
    "jsonrpc":"2.0",
    "method":"tools/call",
    "params":{
      "name":"analyze_item",
      "arguments":{"description":"iPhone 14 Pro Max 256GB space black, good condition, no cracks"}
    },
    "id":3
  }'
```

---

## Development

```bash
# Install
npm install

# Run locally
cp .env.example .env  # Edit with your keys
npm run dev

# Build
npm run build

# Test
npm test
```

---

## Deploy

### Railway (Recommended)

```bash
railway login
railway init
railway up
```

### Docker

```bash
docker build -t trysellr-mcp .
docker run -p 8080:8080 --env-file .env trysellr-mcp
```

### Fly.io

```bash
fly launch
fly deploy
```

---

## Architecture

```
┌─────────────────────────────────────────────┐
│            AI Assistants (Clients)           │
│  Claude │ ChatGPT │ Cursor │ Any MCP Client  │
└────────────────┬────────────────────────────┘
                 │ MCP Protocol (JSON-RPC 2.0)
                 │ POST /mcp
┌────────────────▼────────────────────────────┐
│         TrySellr MCP Server                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐    │
│  │   Auth   │ │  Rate    │ │  Usage   │    │
│  │  Layer   │ │ Limiter  │ │ Tracker  │    │
│  └────┬─────┘ └────┬─────┘ └────┬─────┘    │
│       └─────────┬───┘────────────┘          │
│  ┌──────────────▼──────────────────────┐    │
│  │         Tool Registry (8 tools)      │    │
│  │  analyze │ optimize │ price │ batch  │    │
│  │  negotiate │ demand │ cross │ track  │    │
│  └──────────────┬──────────────────────┘    │
│  ┌──────────────▼──────────────────────┐    │
│  │         Service Layer                │    │
│  │  AI Engine │ Pricing │ Database      │    │
│  └─────────────────────────────────────┘    │
└─────────────────────────────────────────────┘
```

---

## License

MIT — Built by BOEZAC / TrySellr

**https://trysellr.com**