# FLUX Restaurants MCP Server 🍽️

An AI-native restaurant discovery service powered by the [Model Context Protocol](https://modelcontextprotocol.io). Search 2,200+ restaurants across 15+ US cities.

## Tools

| Tool | Description |
|------|-------------|
| `search_restaurants` | Search by cuisine and city |
| `get_featured_restaurant` | Detailed info on FLUX-verified restaurants (menu, hours, story) |
| `recommend_restaurant` | Natural language recommendations ("romantic dinner in LA") |
| `get_best_of_articles` | Curated "Best Of" restaurant lists |
| `list_cities` | All available cities with restaurant counts |

## Quick Start

```bash
npm install
export NEON_DB_URL="your-postgres-connection-string"
node index.js
```

## Usage with Claude Desktop / MCP Clients

Add to your MCP client config:

```json
{
  "mcpServers": {
    "flux-restaurants": {
      "command": "node",
      "args": ["/path/to/flux-restaurants-mcp/index.js"],
      "env": {
        "NEON_DB_URL": "your-postgres-connection-string"
      }
    }
  }
}
```

## Example

```
> search_restaurants(cuisine="ramen", city="New Jersey")

Found 3 restaurants:

**Ramen Nagomi** — Ramen in New Brunswick, NJ ⭐ 4.5 (380 reviews)
Phone: (732) 555-0123
Website: https://ramen-nagomi.fluxrestaurants.com

**Iki Ramen** — Ramen in Hollywood, LA ⭐ 4.3 (245 reviews)
...
```

## Powered by

- [FLUX SEO](https://fluxseo.ai) — AI Visibility for Restaurants
- [FLUX Restaurants](https://fluxrestaurants.com) — AI-Optimized Restaurant Directory

## License

MIT