McDonald's MCP server for AI agents

Let Claude, ChatGPT or your own agent read McDonald's: 3 typed functions through one MCP server. No McDonald's API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just McDonald's

An MCP server for McDonald's 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/mcdonalds
Every site

One MCP server for McDonald's and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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
  • findStoresFinds McDonald's restaurants near a location.

    Arguments

    NameTypeRequired
    arg0{ zip, latitude, longitude }Yes
    arg1{ radiusMiles, maxResults }Yes

    Returns mcdonaldsFindStoresResult

    interface mcdonaldsStoreServices {
      dineIn: boolean;
      driveThru: boolean;
      mcDelivery: boolean;
      mobileOrderAndPay: boolean;
      kioskAudioAccessible: boolean;
      wifi: boolean;
      giftCards: boolean;
    }
    
    interface mcdonaldsStoreHours {
      today: string;
      driveThruToday: string;
      week: Record<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday", string>;
      driveThruWeek: Record<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday", string>;
    }
    
    interface mcdonaldsDeliveryPartner {
      identifier: string;
      name: string;
      url: string;
    }
    
    interface mcdonaldsStore {
      id: string;
      addressLine1: string;
      city: string;
      state: string;
      zip: string;
      country: string;
      phone: string;
      latitude: number;
      longitude: number;
      distanceMiles: number;
      openStatus: string;
      hours: mcdonaldsStoreHours;
      services: mcdonaldsStoreServices;
      amenities: string[];  // the site's own labels, read the values off a result, never guess one from prose
      deliveryPartners: mcdonaldsDeliveryPartner[];
    }
    
    interface mcdonaldsFindStoresResult {
      stores: mcdonaldsStore[];
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/mcdonalds/findStores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mcdonalds.findStores({ latitude: 40.758, longitude: -73.9855 });
  • getMenuReturns McDonald's national menu.

    Arguments

    NameTypeRequired
    arg0{ category }Yes

    Returns mcdonaldsMenu

    interface mcdonaldsMenuItem {
      productId: string;
      name: string;
      category: string;
      url: string;
      badge: string;
    }
    
    interface mcdonaldsMenu {
      categories: string[];
      items: mcdonaldsMenuItem[];
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/mcdonalds/getMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mcdonalds.getMenu();
  • getMenuItemReturns one McDonald's menu item in full.

    Arguments

    NameTypeRequired
    arg0{ productId }Yes

    Returns mcdonaldsMenuItemDetail

    interface mcdonaldsMenuItemNutrient {
      name: string;
      value: number | null;
      unit: string;
      dailyValuePercent: number | null;
      isDisplayed: boolean;
    }
    
    interface mcdonaldsMenuItemComponent {
      name: string;
      servingSize: string;
    }
    
    interface mcdonaldsMenuItemDetail {
      productId: string;
      name: string;
      slug: string;
      tagline: string;
      description: string;
      ingredientStatement: string;
      allergens: string;
      hasComponents: boolean;
      components: mcdonaldsMenuItemComponent[];
      nutrition: mcdonaldsMenuItemNutrient[];
      sourceUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/mcdonalds/getMenuItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mcdonalds.getMenuItem({ productId: "200463" });

Use it from code