freebox-mcp

# Freebox MCP Server

**Give your AI assistant the ability to find free stuff near you — and know what it's worth.**

Freebox tracks free curbside and giveaway listings across 400+ US metros, prices every
find with an LLM valuation chain, and ranks them by estimated resale value. This remote
MCP server exposes that feed to Claude and any other MCP client.

- **Endpoint:** `https://usefreebox.com/api/mcp`
- **Auth:** OAuth 2.1 (one-click connect from Claude) — or manual keys at [usefreebox.com/app/connect](https://usefreebox.com/app/connect)
- **Docs / connect guide:** [usefreebox.com/ai](https://usefreebox.com/ai)

## Connect (Claude)

1. Open claude.ai → Settings → Connectors → **Add custom connector**
2. Paste `https://usefreebox.com/api/mcp`
3. Sign in / create a Freebox account when redirected, approve, done.

Then just ask: *"find free stuff near me worth over $100 and save the best to my vault."*

## Tools

| Tool | What it does |
|---|---|
| `find_free_stuff` | Search live free listings near a ZIP, ranked by estimated resale value + profit |
| `area_summary` | Counts and total estimated value of free finds around a ZIP |
| `save_to_vault` / `my_vault` / `remove_from_vault` | Save and manage finds |
| `create_alert` / `my_alerts` / `delete_alert` | Get pinged when a high-value find drops nearby |

## What's behind it

A Craigslist/OfferUp scraper across 400+ US metros feeding a Supabase index; every
listing priced by an LLM chain (Groq → Cerebras → NVIDIA) tuned on 30k+ resale
valuations; a distance ladder so any US ZIP returns real nearby inventory. Values are
estimates, not guarantees.

Freebox is a paid app ($2.49/wk, $39.99/yr, or $99 lifetime) — connecting and browsing
teasers is free; the full ranked feed requires a subscription.

---
Questions/issues: open an issue here or email howdamain@gmail.com