Platform MCP Server

Food Near Me — MCP Server

Model Context Protocol server for AI-native restaurant discovery — search verified restaurants, retrieve Menu Protocol menus, and validate structured menu data. Plug into Claude Desktop, Cursor, ChatGPT, or any MCP host in about 30 seconds.

Production endpoint: https://foodnear.me/mcp · 5 tools · 4 resources · 3 prompts · No API key (beta)

---

Quick start {#quick-start}

1. Add this to your MCP host config

Cursor — ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\.cursor\mcp.json (Windows)

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "foodnear-me": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://foodnear.me/mcp"]
    }
  }
}

2. Restart your MCP host

3. Try a prompt

“Find vegan Thai restaurants near Brooklyn Bridge and show me a menu for the top result.”

Your agent should call search_restaurants → get_menu (or get_restaurant first).

---

What you get

Tools (5)

Resources (4)

Prompts (3)

---

Configuration

Preview / local: Replace the URL with http://localhost:3000/mcp when running npm run dev in apps/web.

---

Architecture

┌─────────────────────┐     POST /mcp (JSON-RPC)     ┌─────────────────────────┐
│  MCP host           │ ────────────────────────────▶│  apps/web/app/mcp       │
│  (Cursor / Claude)  │     GET /mcp (discovery)     │  Next.js route handler  │
└─────────────────────┘                              └────────────┬────────────┘
                                                                │
                                                                ▼
                                                   ┌─────────────────────────┐
                                                   │  Supabase + PostGIS     │
                                                   │  Menu Protocol (MP)     │
                                                   └─────────────────────────┘

Implementation: apps/web/app/mcp/route.ts · Flow runner: apps/web/lib/mcp/mcp-flow-runner.ts

---

Tool error contract

Failed tools/call responses include structured metadata in _meta.error:

Human-readable text is still in content[0].text for hosts that ignore _meta.

---

Verify

From repo root (with apps/web dev server running for localhost):

# Automated agent flows (13 flows when Supabase + seed configured; 10 without DB)
npm run test:mcp-flows

# Against production
npm run test:mcp-flows:http

# Discovery GETs + MCP tools/list count
npm run smoke:mcp

# Full deploy gate (13 checks)
npm run preflight -w web
# or: ./apps/web/scripts/deploy-preflight.sh https://foodnear.me

Production monitoring: GitHub Actions workflow MCP Production Smoke runs smoke:mcp daily and on manual dispatch (.github/workflows/mcp-smoke.yml).

---

Agent discovery

Scripted flows: apps/web/docs/example-agent-flows.md

---

Data trust model

• Only verification_status: verified restaurants appear in search_restaurants.
• Menus include owner-approved Menu Protocol data with explicit dietary booleans and allergen arrays — agents must not guess from item names alone.
• Read dietary.* flags and allergens[]; do not infer from dish titles.

---

FAQ

Do I need an API key?
No for beta MCP access. Future paid tiers may use API keys or x402 (USDC on Base). See x402-prepaid-spec.md in your local docs/Food Near Me playbook.

Tools not showing after restart?
Confirm the config URL ends with /mcp. Restart the host completely. Run npm run smoke:mcp against your target base URL.

Empty search results?
Beta data is seeded for specific metros (e.g. Williamsburg, NYC). Use coordinates near 40.7128, -74.006 for demos, or run npm run db:seed -w web locally.

Cursor vs Claude config path?
See Quick start above — each host uses a different JSON file; only the mcpServers block matters.

How is this different from DoorDash / Uber Eats APIs?
We expose owner-verified Menu Protocol data for agents — not scraped aggregator menus or ordering checkout.

---

Monorepo layout

This repository ships the MCP server inside the foodnear.me web app:

Business strategy and runbooks live in a separate local docs folder (not in this repo) — see your team's docs/Food Near Me playbook.

---

Development

npm install
cd apps/web && cp .env.example .env.local   # Supabase keys
npm run dev                                 # http://localhost:3000
npm run test:mcp-flows                      # POST localhost:3000/mcp

---

Links

• Website: https://foodnear.me
• GitHub: https://github.com/food-near-me/platform
• Menu Protocol spec: https://github.com/foodnearme/menu-protocol
• Support: https://foodnear.me/support · api@foodnear.me