nicepay-devguide-mcp

MCP server that searches the nicepayments/nicepay-manual tree (markdown).

Document source (live clone by default)

On first use, the server shallow-clones the GitHub repo (unless you point at an existing tree):

| Priority | Path | |----------|------| | 1 | NICEPAY_MANUAL_PATH or DOCS_BASE_PATH — directory to use or clone into | | 2 | $XDG_DATA_HOME/nicepay-devguide-mcp/nicepay-manual (or ~/.local/share/... on Unix) | | 3 | Vendored data/manual next to the CLI (offline fallback after a failed clone) |

Env flags:

• NICEPAY_MANUAL_AUTOCLONE — 0 / false to disable network clone (use only existing path or vendored data/manual).
• NICEPAY_MANUAL_PULL — 1 to git pull --ff-only when the manual dir already exists and has .git.

Requires git on PATH for auto-clone.

Tools

• search_nicepay_docs — keyword search
• get_api_endpoint — URI table + detail pages
• get_code_sample — fenced samples by topic / language
• browse_nicepay_samples — collect samples for one language across docs (implementation reference)
• get_sdk_method — AUTHNICE.* JS SDK

OpenCode (~/.config/opencode/opencode.json)

Prefer launching the bundled CLI with an explicit manual path or rely on autoclone to the user data dir:

"mcp": {
  "nicepay_devguide": {
    "type": "local",
    "command": ["node", "/absolute/path/to/dist/cli.bundle.js"],
    "enabled": true,
    "timeout": 120000
  }
}

Optional env in host config: NICEPAY_MANUAL_PATH, NICEPAY_MANUAL_AUTOCLONE, NICEPAY_MANUAL_PULL.

Develop

cd nicepay-devguide-mcp
pnpm install   # or bun install
bun run build

Vendored offline copy (publish / CI only)

bun run sync-manual   # clone into data/manual and strip .git for shipping in npm tarball

Legal

Manual content is from nicepayments/nicepay-manual; respect upstream terms. This package is tooling plus an optional vendored snapshot.