# Just Now MCP - Creator Search Server

A Model Context Protocol (MCP) server built with Python and `fastmcp` supporting **Streamable HTTP** transport and **STDIO** transport.

## Features

### 🛠️ MCP Tools (1)
1. **`search_creator_facets`** (PostgreSQL / `POSTGRES_DB_URL`)
   - Formats and executes SQL queries against `search_creator_facets(jsonb)` functions.
   - Example query executed:
     ```sql
     SELECT *
     FROM search_creator_facets(
         '{
             "gender": ["Female"],
             "language": ["English"]
         }'::jsonb
     );
     ```

### 💡 MCP Skills / Prompts (1)
1. **`creator_attributes_skill`**
   - Comprehensive guide documenting all creator attributes (`gender`, `language`, `country`, `platform`, `categories`, `followers_range`, `engagement_rate`), valid values, and JSONB filter construction rules.

---

## 🚀 Running the Server

### Streamable HTTP Transport
```bash
uv run python main.py --transport streamable-http --port 8000
```

### Docker Deployment
```bash
docker compose up --build -d
```