Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nsuid-mapper map NSUID 70010000000000 to other regional eShop stores"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Public HTTP API, mapping only |
| Public MCP server (Streamable HTTP, stateless), one tool: |
| API and MCP docs, including install instructions to paste to an agent |
| OpenAPI description of the HTTP API |
| Summary for AI tools |
| Backend of the web page; the only place product data (Savanna) is used. Not public. |
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
Pause every new lookup; cached results are still served:
bun x wrangler deploy --var UPSTREAM_ENABLED:falseResume 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 |
| Routes |
| Input validation and the mapping cache |
| Mapping as offered by the API and MCP, with error outcomes |
| HTTP API handler |
| MCP server |
| Finding the source store |
| Web page backend: input parsing, product details, links |
| Web page backend handler |
| Pause switch and rate limits |
| KV access that never fails a request |
| Web page, docs page, OpenAPI and llms.txt |
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 CloudflareThis server cannot be deployed
Routes natural-language shopping queries to merchant storefronts, returns normalized results.
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.
Public web tools for agents: product extraction, claim checks, webpage QA and ranked audits.
