Faros MCP server for AI agents
Let Claude, ChatGPT or your own agent read Faros: 3 typed functions through one MCP server. No Faros API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Faros
An MCP server for Faros alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/farosEvery site
One MCP server for Faros and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
getMenuReads one Faros restaurant's menu as text from its PDF: food, cocktails, wine, spirits and desserts with prices in pounds and the (V)/(VG) marks…Arguments
Name Type Required locationFarosLocationKey | "Oxford Circus" | "Holborn"Yes pagesstringNo Returns
FarosMenutype FarosLocationKey = "oxford_circus" | "holborn"; interface FarosMenu { location: FarosLocationKey; pdfUrl: string; pageCount: number; pages: { page: number; lines: string[] }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/faros/getMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.faros.getMenu({ location: "holborn", pages: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.faros.getMenu({"location": "holborn", "pages": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/faros/getMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"location":"holborn","pages":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.faros.getMenu({ location: "holborn", pages: "1" });getRestaurantReads Faros's booking page live: both restaurants (Oxford Circus, Holborn) with address, email, phone, opening hours and each one's OpenTable…Arguments
None.
Returns
FarosRestauranttype FarosLocationKey = "oxford_circus" | "holborn"; interface FarosLocation { location: FarosLocationKey; name: string; address: string[]; email: string | null; phone: string | null; hours: string[]; openTableRestaurantId: number | null; bookingUrl: string; } interface FarosRestaurant { name: string; largePartyNote: string | null; emailForPartiesOf: number | null; locations: FarosLocation[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/faros/getRestaurantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.faros.getRestaurant();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.faros.getRestaurant())curl -X POST https://api.bowmark.ai/v1/sites/faros/getRestaurant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.faros.getRestaurant();listMenusLists the menus Faros publishes, one PDF per restaurant (Oxford Circus, Holborn), with the PDF link and the menu page opened at that tab.Arguments
None.
Returns
FarosMenuRow[]type FarosLocationKey = "oxford_circus" | "holborn"; interface FarosMenuRow { location: FarosLocationKey; name: string; pdfUrl: string; menuPageUrl: string; format: "PDF"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/faros/listMenusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.faros.listMenus();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.faros.listMenus())curl -X POST https://api.bowmark.ai/v1/sites/faros/listMenus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.faros.listMenus();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/faros/<function> - OpenAPI
/v1/sites/faros/openapi.json