# 🛒 GenTech Shop — Gaming Intelligence for AI Agents

**Price comparisons, game releases, POE2 builds, and hub status — all available via MCP.**

[![MCP](https://img.shields.io/badge/MCP-v0.1-blue)](https://modelcontextprotocol.io)
[![x402](https://img.shields.io/badge/x402-ready-brightgreen)](https://x402.org)
[![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)

---

## Why GenTech Shop?

Agents need gaming data — and there's no API for it. Steam doesn't expose wishlist deals programmatically. Game release calendars are scattered across 20+ sites. POE2 builds change every patch.

GenTech Shop bridges the gap: **structured gaming data, delivered via MCP tools that any agent can call.**

---

## Services

| Tool | What It Does | Data Source |
|------|-------------|-------------|
| `gaming_deals` | Current Steam wishlist prices + discounts | Vault wishlist JSON |
| `release_calendar` | Upcoming game releases for tracked titles | Web search + vault cache |
| `poe2_build_health` | Path of Exile 2 patch impact on builds | Vault build JSONs |
| `gaming_hub_status` | Sync status + available data overview | Vault Gaming/ directory |

---

## How to Access

### Option 1: MCP (for AI agents)

Install the GenTech Agent Kit to use Shop tools via MCP:

```bash
# Coming soon — pip install or direct clone
git clone https://github.com/ProtoJay4789/genTech-agent-kit.git
cd genTech-agent-kit
pip install -e .
```

The Shop tools register automatically as MCP tools.

### Option 2: Direct HTTP (for humans)

Each tool is also available as a web endpoint at `https://gentechlabs.net/v1/shop/`.

---

## Service Details

### `gaming_deals`

Returns current Steam wishlist deals with prices, discounts, and direct links.

```
gaming_deals(username: "jordan" | "vanito", platform?: "steam")
```

**Example output:**
```json
[
  {
    "game": "Path of Exile 2",
    "platform": "steam",
    "normal_price": 29.99,
    "sale_price": 23.99,
    "discount_pct": 20,
    "url": "https://store.steampowered.com/app/..."
  }
]
```

### `release_calendar`

Upcoming game releases filtered by tracked titles.

```
release_calendar(from_date?: "YYYY-MM-DD", to_date?: "YYYY-MM-DD", genres?: string[])
```

### `poe2_build_health`

Current POE2 patch impact for each tracked build.

```
poe2_build_health(class_name?: "monk" | "warrior" | "vanito")
```

**Example output:**
```json
{
  "current_patch": "0.2.1",
  "builds": [
    {"name": "Monk", "health": "stable", "last_updated": "2026-07-10"},
    {"name": "Warrior", "health": "nerfed", "notes": "Sunder damage reduced 15%"}
  ]
}
```

### `gaming_hub_status`

Returns current sync state and available data.

```
gaming_hub_status()
```

---

## Status Dashboard

Live hub: [ProtoJay4789.github.io/gaming/](https://ProtoJay4789.github.io/gaming/)

| Metric | Value |
|--------|-------|
| Data Sources | 18+ files |
| Builds Tracked | Monk, Warrior, Vanito |
| Wishlists Tracked | Jordan, Vanito |
| Last Sync | Nightly (auto) |

---

## Roadmap

- **v0.1** — README + MCP plugin (current)
- **v0.2** — FiatDock listing for paid MCP calls
- **v0.3** — Loadbay integration
- **v0.4** — HOL registry for x402 per-endpoint payments
- **v1.0** — Human-facing gaming dashboard

---

## Built by GenTech Labs

[![GenTech Labs](https://img.shields.io/badge/GenTech-Labs-8B0000)](https://github.com/ProtoJay4789)
[![Agent Kit](https://img.shields.io/badge/Agent%20Kit-v0.3.0-blueviolet)](https://github.com/ProtoJay4789/genTech-agent-kit)

---

## UE5.8 MCP Integration

UE5.8 ships with native MCP support — connect GenTech Shop as a live data source inside the Unreal Editor.

**Run the server in SSE mode:**

```bash
pip install -r requirements.txt
python server.py sse
```

Starts on `http://localhost:8000/sse` by default.

**In UE5.8:**
1. Enable **MCP Client** in Plugins → search "MCP"
2. Restart editor, open **Window → MCP Client**
3. Add connection: `http://localhost:8000/sse`
4. Click Connect — all 4 tools become callable in Blueprints/Python