Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Food Near Me

✓ vom Dienst · foodnear.me

von food-near-meVersion 1.1.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryme.foodnear/foodnear-me

So installierst du es

Was es kann

AI-native restaurant discovery: verified/menu-indexed/discovered tiers + signed allergy-safety data.

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Spiele, Sport, Essen & Lernen

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-07-18

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/4 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Food Near Me. Folge https://mcp.popnx.com/i/me-foodnear-foodnear-me.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (foodnear.me) · ✓ Befehle geprüft am 20. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameFood Near Me
    Remote MCP server URL · Adressehttps://foodnear.me/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsFood Near Me

  4. Ausprobieren

    Nutze Food Near Me und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Food Near Me nutzt, oder ein Werkzeug von Food Near Me in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameFood Near Me
    Connection · Adressehttps://foodnear.me/mcp
  3. Food Near Me im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Food Near Me aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Food Near Me und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Food Near Me nutzt, oder ein Werkzeug von Food Near Me in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user foodnear-me https://foodnear.me/mcp
  3. /mcp in Claude Code eingeben

    Food Near Me sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Food Near Me und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Food Near Me nutzt, oder ein Werkzeug von Food Near Me in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Food Near Me und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Food Near Me nutzt, oder ein Werkzeug von Food Near Me in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Food Near Me und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Food Near Me nutzt, oder ein Werkzeug von Food Near Me in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://foodnear.me/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Food Near Me nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user foodnear-me https://foodnear.me/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "foodnear-me": {
      "url": "https://foodnear.me/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "foodnear-me": {
      "type": "http",
      "url": "https://foodnear.me/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ foodnear.me
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.1.0
In der Registry veröffentlichti
18. Juli 2026
Code zuletzt geänderti
31. Okt. 2026
Zuletzt geprüft
16. Nov. 2026
Entwickler
food-near-me
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 16. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • search_restaurants

    Call this tool when the user wants restaurant or food discovery near a known location and may need menu trust signals. Input Requirements (CRITICAL): provide either flat `lat`/`lng` or Google-style `locationBias.circle.center.latitude`/`longitude`; if the user gave only a vague p

  • get_restaurant

    Call this tool after `search_restaurants` when you need a detailed restaurant profile for a returned `id`. Input Requirements (CRITICAL): `restaurant_id` MUST be a UUID copied from a `search_restaurants` result; do not invent IDs. Returns Schema.org/Restaurant JSON-LD markup plus

  • get_menu

    Call this tool only when a `search_restaurants` or `get_restaurant` response has `menu_available: true`. Input Requirements (CRITICAL): `restaurant_id` MUST be a UUID copied from a prior FNM result. Returns the full menu in Menu Protocol v1.0 format with item dietary booleans, de

  • get_ado_score_breakdown

    Call this tool when a restaurant owner, operator, or agent wants to understand why a restaurant is more or less agent-ready. Input Requirements (CRITICAL): `restaurant_id` MUST be a UUID copied from a FNM result. Shows ADO (Agent Discovery Optimization) scoring across menu comple

  • get_safety_attestation

    Call this tool when you need a citable, tamper-evident allergy-safety statement for ONE restaurant — for example before telling a user a place is safe for a severe allergy. Input Requirements (CRITICAL): `restaurant_id` MUST be a UUID copied from a prior FNM result. Returns an ex

  • validate_menu_protocol

    Call this tool when validating a draft or exported Menu Protocol payload before submission or integration. Input Requirements (CRITICAL): provide a JSON object in `payload`; set `strict: true` when checking formal spec compliance, and leave strict false for exploratory debugging

  • explore_area_for_diet

    Call this tool when the user wants a neighborhood overview that surfaces trust tiers explicitly — for example, "what's good for vegan eaters within a mile of this location" or "survey the area around X". Input Requirements (CRITICAL): `location` MUST be `{latitude, longitude}` (G

  • compare_restaurants_for_diet

    Call this tool when the user wants a side-by-side dietary comparison for 2 to 5 specific restaurants already identified in FNM results. Input Requirements (CRITICAL): `restaurant_ids` MUST be UUIDs copied from prior FNM responses, and `dietary` MUST include at least one supported

  • find_restaurants_along_route

    Call this tool when the user wants route-adjacent dining options between two known coordinates and may care about dietary fit. Input Requirements (CRITICAL): both `origin` and `destination` MUST be `{latitude, longitude}` objects; optional `route_polyline` MUST be a valid encoded

  • find_safe_places_near_me

    Call this tool when the user needs a place that is safe for a specific allergy or diet near a location — for example "where can my celiac kid eat near Brickell tonight". Input Requirements (CRITICAL): `location` MUST be `{latitude, longitude}`; `needs` MUST list one or more of `g

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain foodnear.me bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 20 Tagen

  • – Nicht zutreffend

    Hat eine Lizenz

    Nicht relevant: Cloud-Server des Inhabers von foodnear.me; du führst keinen Code aus dem Repo aus

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 149 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 10 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/me-foodnear-foodnear-me.svg)](https://mcp.popnx.com/en/servers/me-foodnear-foodnear-me)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni

  • Mehr Sterne als 0 % der anderen 1683 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 12 % der anderen 1683 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1683 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Food Near Me sicher?

Er hat 4 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 20 Tagen geändert, und die neueste Version (1.1.0) kam vor 4 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

LearnHouse

Build, edit and run courses, learning paths and communities in your LearnHouse academy.

von learnhouseWeit verbreitet★ 2482Aktualisiert gestern

Läuft in der Cloud✓ vom Dienst · learnhouse.app

Anime Garden

Anime Garden MCP for anime torrent discovery.

von yjl9903Wachsend★ 1413Aktualisiert vor 16 Tagen

Läuft in der Cloud✓ animes.garden

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

von aikarjalWachsend↓ 1399/Wo.★ 89 Sterne des ganzen ReposAktualisiert vor 11 Tagen

Läuft auf deinem Computer✓ vom Dienst · wilm.ai

Lumify Sports Intelligence

Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.

von lumifyaiAm Anfang★ 15Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · lumify.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

von joshsymondsAm Anfang★ 13Aktualisiert vor 7 Monaten

Läuft in der CloudRepo archiviert✓ vom Dienst · savecraft.gg
Im Vergleich mit ähnlichen
Dieser
Food Near Me
LearnHouseAnime GardenWilmAILumify Sports IntelligenceSavecraft
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinJaNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/45/54/43/34/43/4
Lizenz–AGPL-3.0AGPL-3.0MITMITApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Food Near Me — MCP Server

Model Context Protocol server for AI-native restaurant discovery — three-tier search (verified → menu_indexed → discovered), Menu Protocol menus, and structured menu validation. Plug into Claude Desktop, Cursor, ChatGPT, or any MCP host in about 30 seconds.

Production endpoint: https://foodnear.me/mcp · 8 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 (8)
ToolDescription
search_restaurantsThree-tier geo search by lat/lng — verified → menu_indexed → discovered; check menu_available before get_menu
get_restaurantRestaurant profile with Schema.org JSON-LD + Menu Protocol extensions
get_menuFull Menu Protocol v1.0 menu (dietary flags, allergens, signatures)
get_ado_score_breakdownADO score factors and improvement recommendations
validate_menu_protocolValidate a Menu Protocol JSON payload before publish
explore_area_for_dietComposite: bucketed neighborhood overview (verified / menu_indexed / discovered); optional dietary filter narrows the verified tier only
compare_restaurants_for_dietComposite: compare 2–5 known restaurants by dietary-eligible menu items and trust tier ranking
find_restaurants_along_routeComposite: route-adjacent restaurant discovery between origin/destination with optional dietary ranking
get_safety_attestationSigned (Ed25519, fnm-safety-v1) allergy-safety tier statement for one restaurant; unknown + advisory when uncurated
find_safe_places_near_meThe pack: at most 3 human-curated places for an allergy need, each with curator_checked_at; left_out cut line; explicit empty_state
Resources (4)
URIContent
foodnearme://spec/menu-protocolMenu Protocol v1.0 specification
foodnearme://spec/openapiOpenAPI 3.1 spec pointer
foodnearme://agent/skillAgent skill summary
foodnearme://examples/search-flowExample search → menu flow
Prompts (3)
PromptArgsGuides agent to
find_dinner_near_melocation (required), cuisine?, dietary?search_restaurants → get_menu
dietary_constrained_menurestaurant_id, restrictionsget_menu with explicit MP flags/allergens
validate_my_menustrict? (true for strict mode)validate_menu_protocol

Configuration

SettingValue
MCP URLhttps://foodnear.me/mcp
TransportHTTP JSON-RPC (POST); discovery via GET /mcp
AuthNone during beta (rate limits apply)
Registryme.foodnear/foodnear-me (official MCP Registry)

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

Operational tool filter: set FNM_MCP_ENABLED_TOOLS=search_restaurants,get_menu to expose only a comma-separated subset in tools/list and GET /mcp. Leave unset or * to expose all tools. This is for temporary degradation/context control, not privacy or auth.


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:

FieldMeaning
codeVALIDATION_ERROR · NOT_FOUND · UPSTREAM · RATE_LIMITED · UNKNOWN
messageWhat went wrong
hintHow to fix the request
retryableWhether the agent should retry
docshttps://foodnear.me/docs#quick-start

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 (14 flows when Supabase + seed configured; 11 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

Three-tier trust model copy parity (local files)

npm run check:discovery-copy

Full deploy gate (13 checks + discovery copy on production URL)

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

FileURL
llms.txthttps://foodnear.me/llms.txt
llms-full.txthttps://foodnear.me/llms-full.txt
MCP manifesthttps://foodnear.me/.well-known/mcp-server.json
AgentRoothttps://foodnear.me/.well-known/agentroot.json
Skill filehttps://foodnear.me/SKILL.md
OpenAPIhttps://foodnear.me/openapi.json
Web quick referencehttps://foodnear.me/docs

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


Data trust model (three-tier search)

  • search_restaurants returns verified → menu_indexed → discovered.
  • Every result includes verification_status and menu_available. Call get_menu only when menu_available is true.
  • Verified — owner-approved MP; authoritative for dietary/allergen claims.
  • menu_indexed — automated/public MP menu; cite with caveat — not owner-verified.
  • discovered — place only; do not cite menu items.
  • Trust progression: discovered → menu_indexed → verified. See https://foodnear.me/attribution for data sources.

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 verified menus are seeded for specific metros (e.g. Williamsburg, NYC). 7 `menu_indexed` restaurants in Williamsburg have automated menus from website ingest. Discovered place listings cover many US metros — use coordinates in an imported region. Demo coords: 40.7128, -74.006. Run npm run db:seed -w web locally for verified test data.

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:

PathPurpose
apps/webNext.js app — MCP at `/mcp`, landing, API routes
packages/menu-protocolMenu Protocol schema + validators
databaseMigrations, seeds, schema
server.jsonOfficial MCP Registry metadata

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

Operator: menu_indexed website ingest

Promote discovered → menu_indexed via free website/ordering-platform parsers (ChowNow API, order.online, Sauce, Squarespace, BentoBox, Toast, Playwright). Always dry-run first — headless is slow.

cd apps/web

npm run db:probe:menu-batch -- --headless --limit=10 npm run db:import:menu-indexed:website:headless:dry-run -- --limit=10 npm run db:import:menu-indexed:website:headless -- --limit=10 # live

No Uber Eats / DoorDash / Grubhub / RapidAPI scrapers. See apps/web/docs/example-agent-flows.md.


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