Nintendo MCP server for AI agents

Let Claude, ChatGPT or your own agent read Nintendo: 9 typed functions through one MCP server. No Nintendo API key needed.

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

Connect

Just Nintendo

An MCP server for Nintendo 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/nintendo
Every site

One MCP server for Nintendo 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 9
  • browseCategoryBrowse a whole department or platform family with no keyword.

    Arguments

    NameTypeRequired
    categorystringYes
    options{ limit?: number }No

    Returns NintendoSearchResult

    interface NintendoProductSummary {
      sku: string;
      urlKey: string;
      url: string;
      title: string;
      platform: string | null;
      currency: string | null;
      regularPrice: number | null;
      finalPrice: number | null;
      discounted: boolean | null;
      stockStatus: string | null;  // the site's own label, read the value off a result, never guess one from prose
      availability: string[];  // the site's own labels, read the values off a result, never guess one from prose
      categoryIds: string[];  // matches listCategories' id, so a result's own category can feed browseCategory
    }
    
    interface NintendoSearchResult {
      products: NintendoProductSummary[];
      totalHits: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/browseCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.browseCategory("games");
  • getMyNintendoRewardsBalanceRead the signed-in caller's My Nintendo Points balance and reward history.

    Arguments

    None.

    Returns NintendoRewardsBalance

    interface NintendoRewardsBalance {
      wallet: Record<string, unknown>;  // the site's own point wallet: total, points by kind, expirations
      history: Record<string, unknown>[];  // first page of point transactions, newest first
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/getMyNintendoRewardsBalance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.getMyNintendoRewardsBalance();
  • getProductRead one product page the way a shopper reads it: name, platform, current and list price, in-stock flag, description, box art image, genre/feature…

    Arguments

    NameTypeRequired
    refstringYes

    Returns NintendoProduct

    interface NintendoProduct {
      sku: string;
      nsuid: string | null;
      name: string;
      urlKey: string;
      url: string;
      platform: string | null;
      currency: string | null;
      regularPrice: number | null;
      finalPrice: number | null;
      discounted: boolean | null;
      imageUrl: string | null;
      availability: string[];  // the site's own labels, read the values off a result, never guess one from prose
      features: string[];  // the site's own labels, read the values off a result, never guess one from prose
      genres: string[];
      compatibilityStatus: string | null;
      compatibilityCaption: string | null;
      description: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.getProduct("the-legend-of-zelda-tears-of-the-kingdom-switch");
  • getSupportArticleRead one support article in full.

    Arguments

    NameTypeRequired
    refstringYes

    Returns NintendoSupportArticle

    interface NintendoSupportArticle {
      id: string;
      title: string;
      products: string[];  // which systems/products the article applies to
      summary: string | null;
      body: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/getSupportArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.getSupportArticle("22359");
  • listCategoriesList the store's own departments as its Shop menu shows them.

    Arguments

    None.

    Returns NintendoCategory[]

    interface NintendoCategory {
      id: string;  // the department's slug, as in /us/store/<id>/
      name: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.listCategories();
  • listDealsToday's discounted games and hardware on the Nintendo store.

    Arguments

    NameTypeRequired
    options{ limit?: number }No

    Returns NintendoSearchResult

    interface NintendoProductSummary {
      sku: string;
      urlKey: string;
      url: string;
      title: string;
      platform: string | null;
      currency: string | null;
      regularPrice: number | null;
      finalPrice: number | null;
      discounted: boolean | null;
      stockStatus: string | null;  // the site's own label, read the value off a result, never guess one from prose
      availability: string[];  // the site's own labels, read the values off a result, never guess one from prose
      categoryIds: string[];  // matches listCategories' id, so a result's own category can feed browseCategory
    }
    
    interface NintendoSearchResult {
      products: NintendoProductSummary[];
      totalHits: number;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.listDeals();
  • listNewsNintendo's own announcements and news articles.

    Arguments

    None.

    Returns NintendoNewsList

    interface NintendoNewsArticle {
      id: string;
      title: string;
      slug: string;
      url: string;
      publishDate: string | null;  // ISO 8601
      excerpt: string | null;
      imageUrl: string | null;
      tags: string[];  // the site's own content-tag ids, e.g. "articleCategoryGameNews"
    }
    
    interface NintendoNewsList {
      articles: NintendoNewsArticle[];  // newest first, up to 30
      total: number | null;  // how many articles the site holds in all
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.listNews();
  • searchProductsSearch Nintendo's own store catalog by keyword.

    Arguments

    NameTypeRequired
    querystringYes
    options{ limit?: number }No

    Returns NintendoSearchResult

    interface NintendoProductSummary {
      sku: string;
      urlKey: string;
      url: string;
      title: string;
      platform: string | null;
      currency: string | null;
      regularPrice: number | null;
      finalPrice: number | null;
      discounted: boolean | null;
      stockStatus: string | null;  // the site's own label, read the value off a result, never guess one from prose
      availability: string[];  // the site's own labels, read the values off a result, never guess one from prose
      categoryIds: string[];  // matches listCategories' id, so a result's own category can feed browseCategory
    }
    
    interface NintendoSearchResult {
      products: NintendoProductSummary[];
      totalHits: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.searchProducts("mario");
  • searchSupportSearch Nintendo's support knowledge base by keyword.

    Arguments

    NameTypeRequired
    querystringYes

    Returns NintendoSupportSearchResult[]

    interface NintendoSupportSearchResult {
      id: string;  // feed into getSupportArticle
      title: string;
      question: string | null;
      snippet: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nintendo/searchSupport

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nintendo.searchSupport("switch won't charge");

Use it from code