Skip to main content
Glama
Sign In
nsuid-mapper

nsuid-mapper

by maixiang-sh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

nsuid-mapper-web

Web page, HTTP API and MCP server for nsuid-mapper, on Cloudflare Workers at https://nsuid-mapper.ohneko.com.

Unofficial project; not affiliated with or endorsed by Nintendo.

Path

What

/

Web page: map an NSUID or store link, with product details and store links

/api/v1/map

Public HTTP API, mapping only

/mcp

Public MCP server (Streamable HTTP, stateless), one tool: map_nsuid

/docs/

API and MCP docs, including install instructions to paste to an agent

/openapi.json

OpenAPI description of the HTTP API

/llms.txt

Summary for AI tools

/api/web/lookup

Backend of the web page; the only place product data (Savanna) is used. Not public.

How it works

  • Mapping comes from nsuid-mapper, installed from GitHub at a pinned commit and imported from nsuid-mapper/source. Update it with bun add github:maixiang-sh/nsuid-mapper#<commit>.

  • Results are cached in KV (MAP_CACHE): one day when every target mapped, five minutes otherwise. Upstream failures are not cached.

  • Only cache misses reach Nintendo, and only they count against the per-IP rate limit (API_LIMITER, about 20 a minute; Cloudflare counts approximately).

  • Without from, the source store is found by asking the JP, US, GB, HK and KR stores.

  • Requests that would reach Nintendo pass a guard: the pause switch, then about 20 a minute per IP (429), then about 300 a minute from everyone together (503 busy). Cached results skip the guard. KV failures (including a used-up daily quota) never fail a request: a read counts as a miss and a write is skipped.

Related MCP server: rootvine-mcp

If the service is abused

Pause every new lookup; cached results are still served:

bun x wrangler deploy --var UPSTREAM_ENABLED:false

Resume with bun run deploy. The variable can also be changed in the Cloudflare dashboard, but the next deploy resets it to wrangler.jsonc.

File

Role

src/index.ts

Routes

src/map.ts

Input validation and the mapping cache

src/run.ts

Mapping as offered by the API and MCP, with error outcomes

src/api.ts

HTTP API handler

src/mcp.ts

MCP server

src/detect.ts

Finding the source store

src/lookup.ts

Web page backend: input parsing, product details, links

src/web.ts

Web page backend handler

src/limit.ts

Pause switch and rate limits

src/cache.ts

KV access that never fails a request

public/

Web page, docs page, OpenAPI and llms.txt

Development

Requires Bun. Deploying needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID in the environment, or bun x wrangler login.

bun install
bun run dev     # local server at http://localhost:8787 (requests reach Nintendo)
bun run check   # typecheck, format check, tests
bun run deploy  # deploy to Cloudflare

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Shop Server

      johan-perso
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.
      13 npm
      3
      MIT

    • rootvine-mcp

      RagingOrangutan
      A
      license
      A
      quality
      B
      maintenance
      Cross-platform music link resolution for AI agents. Resolve any song or album across Spotify, Apple Music, Amazon, YouTube, and more. Returns affiliate-ready links with click tracking
      5
      58 npm
      3
      MIT

    • Lumi App Finder MCP

      alice51849
      A
      license
      Not graded
      quality
      B
      maintenance
      Gives AI assistants a read-only tool to match a user's task or buyer need to verified Lumi Studio iOS apps across 29 apps and all 50 Apple locales, returning localized context, purchase model, guide, and direct App Store links. Supports interactive localized cards via the MCP Apps extension and includes a bundled offline snapshot without analytics.
      MIT

    • SteamMCP

      rayyan2099
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to recommend Steam games from natural language by searching games, finding similar titles, filtering by tags and platform, and retrieving detailed game metadata.
      1
      MIT