# Valérie MCP — French Real Estate Assistant

Connect any MCP client to **Valérie Florent**, an AI specialist for the French real estate market.

## What Valérie can do

- 🏠 Answer questions about French property — prices, trends, neighbourhoods
- 📊 Retrieve real **DVF transaction data** (22M+ transactions, 2020–2025) for any location in France
- 📶 Check **internet coverage** (fibre, 4G, 5G) at any French address across all operators
- 🌍 Responds in **French or English**

## Quick start

**Claude Code:**
```bash
claude mcp add --transport http valerie https://arenafriend.com/mcp
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "valerie": {
      "url": "https://arenafriend.com/mcp"
    }
  }
}
```

**MCP URL:** `https://arenafriend.com/mcp`

## Authentication

Valérie uses email OTP — no password needed:

```
1. authenticate({ email: "you@example.com" })
2. verify_code({ email: "you@example.com", code: "123456" })
3. ask_valerie({ question: "Quelles sont les prix à Antibes ?" })
```

## Tools

| Tool | Description |
|---|---|
| `authenticate` | Request a one-time login code by email |
| `verify_code` | Confirm the code and open a session |
| `ask_valerie` | Send a question, get Valérie's answer |
| `get_status` | Check remaining questions + subscription |
| `subscribe` | Get a Stripe checkout link to upgrade |
| `list_conversations` | Browse all your conversations (web, email, MCP) |
| `get_conversation` | Read the full history of any conversation |

## Pricing

- **Free:** 5 questions
- **Paid:** €5/month — 100 questions/month (Stripe, cancel anytime)

## About

Valérie is powered by [Home by Arenafriends](https://arenafriend.com) — a free app (iOS & Android) that checks internet coverage at any French address before you buy or rent.

## Self-hosting

```bash
git clone https://github.com/hjg/valerie-mcp
cd valerie-mcp
npm install
# stdio (local)
node server.mjs
# HTTP (public)
VALERIE_URL=https://your-instance.com node server.mjs --http
```