nagoc-mcp
v1.1.5
Published
An MCP Server for Digital Wallet Cards API
Readme
nagoc.work.mcp
A free Model Context Protocol (MCP) server that dynamically connects any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, Zed, etc.) to your digital wallet platform API.
Because it fetches the full OpenAPI schema automatically at runtime, it requires zero manual endpoint maintenance — any new endpoints added to the API are instantly available as AI tools.
Features
- Dynamic — fetches and parses the live OpenAPI schema on every startup
- Always up to date — uses
@latestso every Claude restart pulls the newest version automatically - Secure — your API key is passed via an environment variable and never stored in code
- Zero install — runs via
npxwith no cloning required - Multi-platform — works with Claude Desktop, Cursor, Windsurf, Zed, and any stdio MCP client
- Automation Ready — Includes a
get_api_infotool that allows Claude to instantly configure n8n or Zapier workflows with your correct Base URL and headers. - Human-in-the-loop — Claude Desktop will prompt for confirmation before executing any destructive (DELETE) operations.
Requirements
- Node.js v18 or above (see below for how to install)
- An active API key from your account
Step 1 — Install Node.js (one-time setup)
Node.js is a free program that allows this MCP to run on your computer. You only need to install it once.
- Go to https://nodejs.org
- Click the big "Download Node.js (LTS)" button
- Open the downloaded file and click Next → Next → Finish (just like installing any normal app)
- That's it — you're ready!
Not sure if you already have Node.js? Press
Win + R, typecmd, press Enter, then typenode -vand press Enter. If you see a version number (e.g.v20.x.x), you're all set.
Step 2 — Setup (Claude Desktop)
Open your claude_desktop_config.json file and add the following:
Note: The
@latesttag ensures that every time Claude Desktop restarts, it automatically pulls the latest version of this MCP. No manual updates required.
Windows:
{
"mcpServers": {
"nagoc-bm-mcp": {
"command": "cmd",
"args": ["/c", "npx", "-y", "nagoc-mcp@latest"],
"env": {
"API_KEY": "paste-your-api-key-here",
"API_BASE_URL": "https://your-custom-site.com"
}
}
}
}macOS / Linux:
{
"mcpServers": {
"nagoc-bm-mcp": {
"command": "npx",
"args": ["-y", "nagoc-mcp@latest"],
"env": {
"API_KEY": "paste-your-api-key-here",
"API_BASE_URL": "https://your-custom-site.com"
}
}
}
}Important: If you are using a white-labeled or custom version of the platform, replace
https://your-custom-site.comwith your actual portal URL. If you leave this out, it will default to the standard platform URL.
Save the file and restart Claude Desktop. The MCP server will connect automatically.
Supported Clients
Any client that supports local stdio MCP servers:
- Claude Desktop
- Cursor
- Windsurf
- Zed
Environment Variables
| Variable | Required | Description |
|---|---|---|
| API_KEY | ✅ Yes | Your secret API key |
| API_BASE_URL | ❌ Optional | Custom API endpoint URL (contact us for details) |
Security
- DELETE operations are flagged with
destructiveHint— Claude Desktop will show a confirmation dialog before executing them - GET operations are flagged with
readOnlyHint— they run silently with no confirmation needed - Your API key is never exposed in error messages or logs
License
ISC © nagoc
