Epic Games Store MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Epic Games Store: 32 typed functions through one MCP server. No Epic Games Store API key needed.

Functions
32
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Epic Games Store

An MCP server for Epic Games Store 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/epicgames
Every site

One MCP server for Epic Games Store 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 that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 23
  • browseGamesBrowse the store catalogue like its Browse page.

    Arguments

    NameTypeRequired
    args{ tag?: string; priceCeiling?: number; sortBy?: 'new' | 'price'; limit?: number }No

    Returns BrowseGamesResult

    interface GameSearchResult {
      id: string;
      title: string;
      namespace: string;
      productSlug: string | null;
      currentPrice: number;
      originalPrice: number;
      discount: number;
      releaseDate: string | null;
      seller: { id: string; name: string };
      tags: Array<{ id: string; name: string }>;
      images: Array<{ type: string; url: string }>;
    }
    
    interface BrowseGamesResult {
      games: GameSearchResult[];
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/browseGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.browseGames({ tag: "Action", limit: 5 });
  • getAccountThe signed-in caller's own Epic Games account settings, returned raw.

    Arguments

    None.

    Returns GetAccountResult

    interface GetAccountResult {
      account: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getAccount();
  • getAchievementProgressThe signed-in caller's own achievements in one game.

    Arguments

    NameTypeRequired
    args{ slug?: string; namespace?: string }Yes

    Returns GetAchievementProgressResult

    interface AchievementProgressEntry {
      achievementName: string;
      unlocked: boolean;
      progress: number;
      xp: number;
      unlockDate: string | null;
      isBase: boolean;
    }
    
    interface GetAchievementProgressResult {
      totalXP: number;
      totalUnlocked: number;
      achievements: AchievementProgressEntry[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getAchievementProgress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getAchievementProgress({ namespace: "fn" });
  • getAchievementsA game's achievement list as the store shows it.

    Arguments

    NameTypeRequired
    args{ slug?: string; namespace?: string }Yes

    Returns GetAchievementsResult

    interface StoreAchievement {
      name: string;
      displayName: string;
      description: string;
      hidden: boolean;
      xp: number;
      unlockedPercent: number | null;
      iconUrl: string | null;
      isBase: boolean;
    }
    
    interface GetAchievementsResult {
      namespace: string;
      totalXP: number;
      achievements: StoreAchievement[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getAchievements

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getAchievements({ namespace: "7e508f543b05465abe3a935960eb70ac" });
  • getCartThe signed-in caller's cart.

    Arguments

    None.

    Returns GetCartResult

    interface GetCartResult {
      cart: unknown; // the site's own { Cart { cartItems { elements } } } JSON, raw
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getCart();
  • getGameOne game's store page as data: title, description, developer, publisher, editions and add-ons listed on the page, system requirements, key art, and…

    Arguments

    NameTypeRequired
    slugstringYes

    Returns GetGameResult

    interface GameEdition {
      title: string;
      offerId: string;
      description: string;
    }
    
    interface GameSystemRequirement {
      platform: string;
      requirements: Array<{ label: string; minimum: string; recommended: string }>;
    }
    
    interface GameDetail {
      title: string;
      namespace: string;
      description: string;
      productSlug: string;
      developer: string | null;
      publisher: string | null;
      editions: GameEdition[];
      systemRequirements: GameSystemRequirement[];
      images: Array<{ type: string; url: string }>;
      basePrice: number | null;
      currencyCode: string;
    }
    
    interface GetGameResult {
      game: GameDetail;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getGame("ghostrunner-2");
  • getGameRatingsHow players rate a game on the Epic Games Store: the average star rating and the store's player-poll results ("This game has Diverse Characters")…

    Arguments

    NameTypeRequired
    args{ slug?: string; offerId?: string }Yes

    Returns GetGameRatingsResult

    interface PlayerPollResult {
      title: string;
      phrase: string;
      votes: number;
      tagId: number;
    }
    
    interface GetGameRatingsResult {
      namespace: string;
      averageRating: number | null;
      polls: PlayerPollResult[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getGameRatings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getGameRatings({ offerId: "a9748abde1c94b66aae5250bb9fc5503" });
  • getLibraryThe games the signed-in caller owns on Epic.

    Arguments

    NameTypeRequired
    opts{ cursor?: string }No

    Returns GetLibraryResult

    interface GetLibraryResult {
      library: unknown; // the library service's own JSON, raw; pass its cursor back as `cursor`
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getLibrary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getLibrary();
  • getNewsArticleOne Epic Games Store news article's full text (HTML), date, author, category and images.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns GetNewsArticleResult

    interface NewsArticle {
      title: string;
      slug: string;
      url: string;
      date: string;
      author: string;
      category: string;
      content: string;
      images: string[];
    }
    
    interface GetNewsArticleResult {
      article: NewsArticle;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getNewsArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getNewsArticle("epic-games-store-comes-to-iphones-in-brazil-with-fortnite-and-rocket-league-sideswipe");
  • getPriceWhat a game costs right now in a given country: current price, original price, discount percentage, the currency, and when the sale ends.

    Arguments

    NameTypeRequired
    args{ slug?: string; offerId?: string; namespace?: string; country?: string }Yes

    Returns GetPriceResult

    interface GamePrice {
      offerId: string;
      currentPrice: number;
      originalPrice: number;
      discountPercentage: number;
      currencyCode: string;
      saleEndDate: string | null;
    }
    
    interface GetPriceResult {
      price: GamePrice;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getPrice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getPrice({ slug: "ghostrunner-2", country: "US" });
  • getRewardsBalanceThe signed-in caller's Epic Rewards balance.

    Arguments

    None.

    Returns GetRewardsBalanceResult

    interface GetRewardsBalanceResult {
      balance: number;
      balanceCurrency: string;
      pendingBalance: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getRewardsBalance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getRewardsBalance();
  • getServiceStatusWhether Epic's services are up.

    Arguments

    NameTypeRequired
    args{ component?: string }No

    Returns GetServiceStatusResult

    interface ServiceComponent {
      id: string;
      name: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
    }
    
    interface ServiceIncident {
      id: string;
      name: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      impact: string;
      shortlink: string;
      updatedAt: string;
    }
    
    interface GetServiceStatusResult {
      indicator: string;
      description: string;
      components: ServiceComponent[];
      incidents: ServiceIncident[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getServiceStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getServiceStatus();
  • getStorefrontThe store's home page as data.

    Arguments

    NameTypeRequired
    args{ locale?: string; country?: string }No

    Returns GetStorefrontResult

    interface StorefrontSlide {
      title: string;
      eyebrow?: string;
      description?: string;
      linkedProduct?: string;
    }
    
    interface StorefrontGame {
      title: string;
      offerId: string;
      namespace: string;
      productSlug: string | null;
      currentPrice: number | null; // cents
      originalPrice: number | null; // cents
      currencyCode: string | null;
    }
    
    interface StorefrontModule {
      type: string;
      title: string; // the row's heading, e.g. "Featured Discounts"; empty when untitled
      slides: StorefrontSlide[];
      games: StorefrontGame[]; // the games the row lists; empty for a banner
    }
    
    interface GetStorefrontResult {
      modules: StorefrontModule[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getStorefront

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getStorefront({});
  • getWishlistThe signed-in caller's Epic Games Store wishlist, with each game's current price and whether it is on sale.

    Arguments

    None.

    Returns GetWishlistResult

    interface GetWishlistResult {
      wishlist: unknown; // the site's own { Wishlist { wishlistItems { elements } } } JSON, raw
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/getWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.getWishlist();
  • listCollectionOne of the store's own ranked charts.

    Arguments

    NameTypeRequired
    args{ name: string; country?: string; limit?: number; page?: number }Yes

    Returns ListCollectionResult

    interface CollectionEntry {
      position: number;
      /** Rank on the chart's previous update; null when new to the chart. */
      previousPosition: number | null;
      id: string;
      title: string;
      namespace: string;
      productSlug: string | null;
      currentPrice: number;
      originalPrice: number;
      discountPercentage: number;
      currencyCode: string;
    }
    
    interface ListCollectionResult {
      collection: string;
      updatedAt: string | null;
      games: CollectionEntry[];
      /** Rows on the whole chart, not just this page. */
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listCollection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listCollection({ name: "top-sellers" });
  • listDealsGames on sale now, the store's Special Offers, with current price, original price, discount percentage and sale end date, optionally filtered by tag…

    Arguments

    NameTypeRequired
    args{ tag?: string; priceCeiling?: number; sortBy?: 'discount' | 'price' }No

    Returns ListDealsResult

    interface GameDeal {
      id: string;
      title: string;
      namespace: string;
      productSlug: string | null;
      currentPrice: number;
      originalPrice: number;
      discountPercentage: number;
      currencyCode: string;
      saleEndDate: string | null;
      tags: Array<{ id: string; name: string }>;
    }
    
    interface ListDealsResult {
      deals: GameDeal[];
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listDeals();
  • listFreeGamesThe Epic Games Store's free-game rotation: the games free to claim right now and the ones announced as free next, each with title, slug, original…

    Arguments

    NameTypeRequired
    countrystringNo

    Returns ListFreeGamesResult

    interface EpicGamesFreeWindow {
      startDate: string;
      endDate: string;
    }
    
    interface FreeGame {
      id: string;
      title: string;
      namespace: string;
      description: string;
      productSlug: string | null;
      urlSlug: string;
      keyImages: Array<{ type: string; url: string }>;
      seller: { id: string; name: string };
      originalPrice: number;
      currencyCode: string;
      promotions: { current: EpicGamesFreeWindow[]; upcoming: EpicGamesFreeWindow[] };
    }
    
    interface ListFreeGamesResult {
      elements: FreeGame[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listFreeGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listFreeGames("US");
  • listFriendsThe signed-in caller's Epic friends list.

    Arguments

    None.

    Returns ListFriendsResult

    interface ListFriendsResult {
      friends: unknown; // the friends service's own summary JSON, raw
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listFriends

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listFriends();
  • listGameOffersEvery purchasable offer under one game.

    Arguments

    NameTypeRequired
    args{ slug?: string; namespace?: string }Yes

    Returns ListGameOffersResult

    interface GameOffer {
      offerId: string;
      offerType: string;
      title: string;
      basePrice: number;
      releaseDate: string | null;
    }
    
    interface ListGameOffersResult {
      offers: GameOffer[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listGameOffers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listGameOffers({ slug: "ghostrunner-2" });
  • listNewsThe Epic Games Store's news articles, newest first.

    Arguments

    NameTypeRequired
    args{ limit?: number; skip?: number }No

    Returns ListNewsResult

    interface NewsArticleSummary {
      title: string;
      slug: string;
      url: string;
      date: string;
      author: string;
      category: string;
    }
    
    interface ListNewsResult {
      articles: NewsArticleSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listNews();
  • listOrdersThe signed-in caller's Epic purchase history, newest first, returned raw; pass the returned page token as pageToken for the next page.

    Arguments

    NameTypeRequired
    opts{ pageToken?: string }No

    Returns ListOrdersResult

    interface ListOrdersResult {
      history: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listOrders();
  • listTagsThe store's browse tags, genres, features, platforms, events and player-poll tags, each with its id, group and how many games carry it.

    Arguments

    NameTypeRequired
    args{ group?: string }No

    Returns ListTagsResult

    interface StoreTag {
      id: string;
      name: string;
      group: string | null; // the site's own group labels ("genre", "feature", "platform", "event", "usersay", …), read them off a result
      gameCount: number;
    }
    
    interface ListTagsResult {
      tags: StoreTag[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/listTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.listTags({ group: "genre" });
  • searchGamesKeyword search of the Epic Games Store catalogue.

    Arguments

    NameTypeRequired
    querystringYes

    Returns SearchGamesResult

    interface GameSearchResult {
      id: string;
      title: string;
      namespace: string;
      productSlug: string | null;
      currentPrice: number;
      originalPrice: number;
      discount: number;
      releaseDate: string | null;
      seller: { id: string; name: string };
      tags: Array<{ id: string; name: string }>;
      images: Array<{ type: string; url: string }>;
    }
    
    interface SearchGamesResult {
      games: GameSearchResult[];
      total: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/searchGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.searchGames("hades");
Act 9
  • addToCartPut a game or add-on in the signed-in caller's cart.

    Arguments

    NameTypeRequired
    offerIdstringYes
    namespacestringYes

    Returns CartWriteResult

    interface EpicgamesCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface EpicgamesCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface EpicgamesCheckoutSummary { items: EpicgamesCheckoutItem[]; total: string | null; currency: string; }
    
    /** Where to finish: open url, signed in as account. Bowmark never pays. status is ready_to_checkout, needs_login or unavailable (reason + detail say why). */
    interface EpicgamesCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: EpicgamesCheckoutAccount; summary: EpicgamesCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface CartWriteResult {
      result: unknown;
      checkout?: EpicgamesCheckoutHandoff;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.addToCart({ offerId: "<offerId>", namespace: "<namespace>" });
  • addToWishlistAdd a game to the signed-in caller's wishlist.

    Arguments

    NameTypeRequired
    offerIdstringYes
    namespacestring
    The offer's catalogue namespace (searchGames rows carry it).
    Yes

    Returns WishlistWriteResult

    interface WishlistWriteResult {
      result: unknown; // the site's own mutation answer, raw
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/addToWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.addToWishlist({ offerId: "<offerId>", namespace: "<namespace>" });
  • claimFreeGameClaim one of this week's free games into the signed-in caller's library.

    Arguments

    NameTypeRequired
    args{ offerId: string; namespace: string; country?: string }Yes

    Returns ClaimFreeGameResult

    interface ClaimFreeGameResult {
      claimed: boolean;
      alreadyOwned: boolean;
      status: string; // the site's own labels, read the values off a result, never guess one from prose
      offerId: string;
      namespace: string;
      checkoutUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/claimFreeGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.claimFreeGame({});
  • redeemCodeRedeem a product code the caller holds into their Epic library.

    Arguments

    NameTypeRequired
    codestringYes

    Returns RedeemCodeResult

    interface RedeemCodeResult {
      redeemed: boolean;
      code: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/redeemCode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.redeemCode("<code>");
  • removeFriendRemove someone from the signed-in caller's Epic friends, by their Epic display name.

    Arguments

    NameTypeRequired
    displayNamestringYes

    Returns RemoveFriendResult

    interface RemoveFriendResult {
      removed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/removeFriend

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.removeFriend("<displayName>");
  • removeFromCartRemove a line from the signed-in caller's cart.

    Arguments

    NameTypeRequired
    cartItemIdstring
    The cart line's id from getCart, not the offer id.
    Yes

    Returns CartWriteResult

    interface EpicgamesCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; }
    
    interface EpicgamesCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings
    
    interface EpicgamesCheckoutSummary { items: EpicgamesCheckoutItem[]; total: string | null; currency: string; }
    
    /** Where to finish: open url, signed in as account. Bowmark never pays. status is ready_to_checkout, needs_login or unavailable (reason + detail say why). */
    interface EpicgamesCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: EpicgamesCheckoutAccount; summary: EpicgamesCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; }
    
    interface CartWriteResult {
      result: unknown;
      checkout?: EpicgamesCheckoutHandoff;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/removeFromCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.removeFromCart({ cartItemId: "<cartItemId>" });
  • removeFromWishlistRemove a game from the signed-in caller's wishlist.

    Arguments

    NameTypeRequired
    offerIdstringYes
    namespacestring
    The offer's catalogue namespace (searchGames rows carry it).
    Yes

    Returns WishlistWriteResult

    interface WishlistWriteResult {
      result: unknown; // the site's own mutation answer, raw
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/removeFromWishlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.removeFromWishlist({ offerId: "<offerId>", namespace: "<namespace>" });
  • sendFriendRequestSend a friend request from the signed-in caller to an Epic display name.

    Arguments

    NameTypeRequired
    displayNamestringYes

    Returns SendFriendRequestResult

    interface SendFriendRequestResult {
      sent: boolean;
      friendDisplayName: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/sendFriendRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.sendFriendRequest("<displayName>");
  • updateDisplayNameChange the signed-in caller's Epic display name.

    Arguments

    NameTypeRequired
    displayNamestringYes

    Returns UpdateDisplayNameResult

    interface UpdateDisplayNameResult {
      updated: boolean;
      displayName: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/epicgames/updateDisplayName

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.epicgames.updateDisplayName("<displayName>");

Use it from code