@nexvora/mcp-server 0.3.1 → 0.3.3

package/docs/setup/chatgpt-desktop.md

@@ -1,120 +0,0 @@
-# Installing @nexvora/mcp-server in ChatGPT Desktop
-
-ChatGPT Desktop's MCP support is currently in early access and availability varies by plan and region. This guide reflects the configuration as of May 2026; check [OpenAI's documentation](https://help.openai.com) for the latest status.
-
-## Prerequisites
-
-- ChatGPT Desktop (macOS or Windows) with MCP support enabled
-- Node.js ≥ 18 on `PATH`
-- A NexVora account (free tier or above)
-
-## Step 1 — Authenticate
-
-### Option 1 — OAuth Device Grant (recommended)
-
-Run this once per machine to store your credentials:
-
-```bash
-npx @nexvora/mcp-server login
-```
-
-### Option 2 — Personal Access Token
-
-If you cannot run an interactive browser flow (CI, headless servers, shared dev boxes), use a PAT instead:
-
-1. Open **https://app.nxvora.online/app/settings/mcp-tokens**.
-2. Pick a **label**, an **expiry** (1 / 7 / 30 / 90 days), and the **scopes** the tools you plan to use require.
-3. Click **Create token** and copy the resulting `nxv_pat_...` string — it is shown **once**.
-4. Paste it as `NEXVORA_ACCESS_TOKEN` in the `env` block of your `mcp_servers.json` (see Step 3):
-
-```json
-{
-  "servers": [
-    {
-      "name": "nexvora",
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_ACCESS_TOKEN": "nxv_pat_..."
-      }
-    }
-  ]
-}
-```
-
-The server auto-detects PATs by the `nxv_pat_` prefix — no other config change is needed. PATs do not auto-refresh; rotate them before they expire.
-
-## Step 2 — Locate the ChatGPT Desktop MCP config file
-
-| Platform | Config file |
-|----------|-------------|
-| macOS | `~/Library/Application Support/ChatGPT/mcp_servers.json` |
-| Windows | `%APPDATA%\ChatGPT\mcp_servers.json` |
-
-Create the file if it does not exist.
-
-## Step 3 — Add the server
-
-```json
-{
-  "servers": [
-    {
-      "name": "nexvora",
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"]
-    }
-  ]
-}
-```
-
-If you already have other servers in the file, add the object to the `"servers"` array.
-
-## Step 4 — Restart ChatGPT Desktop
-
-Quit and relaunch the app. Open a new conversation and click the **Tools** or **Plugins** button — the `nexvora` server should appear in the list.
-
-Test with:
-
-```
-Check my NexVora wallet balance.
-```
-
-## Environment overrides
-
-```json
-{
-  "servers": [
-    {
-      "name": "nexvora",
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_API_URL": "https://staging.api.nxvora.online"
-      }
-    }
-  ]
-}
-```
-
-## Limitations
-
-- ChatGPT Desktop's MCP integration does not yet support all MCP tool features (e.g. streamed responses). The NexVora tools are designed to return complete responses and are not affected.
-- Tool calls from ChatGPT are subject to OpenAI's usage policies in addition to NexVora's terms.
-
-## Troubleshooting
-
-**Server not listed after restart**
-- Validate the JSON file syntax with a linter (a missing comma will silently break the config).
-- Run `npx @nexvora/mcp-server` in a terminal to confirm the server starts without errors.
-
-**"Not authenticated" errors**
-- Re-run `npx @nexvora/mcp-server login`.
-
-**"Your NexVora PAT was rejected — it has been revoked or expired"**
-- You're using a Personal Access Token and it's no longer valid. PATs do not auto-refresh — generate a new one at **https://app.nxvora.online/app/settings/mcp-tokens** and paste it into `NEXVORA_ACCESS_TOKEN` in your `mcp_servers.json`.
-
-**"Your NexVora PAT is missing the required scope: `tool:...`"**
-- The PAT you're using does not include the scope the tool needs. The exact missing scope is in the error. Generate a new PAT with that scope ticked at **https://app.nxvora.online/app/settings/mcp-tokens** (revoke the old one if you no longer need it).
-
-**MCP option not available in ChatGPT Desktop**
-- MCP support may not be enabled for your account tier. Check [https://help.openai.com](https://help.openai.com) for eligibility.

package/docs/setup/claude-code.md

@@ -1,152 +0,0 @@
-# Installing @nexvora/mcp-server in Claude Code
-
-This guide covers adding the NexVora MCP server to Claude Code so the 12 NexVora platform tools are available in every conversation.
-
-## Prerequisites
-
-- Claude Code installed (`npm install -g @anthropic-ai/claude-code` or the desktop app)
-- Node.js ≥ 18 on `PATH`
-- A NexVora account (free tier or above)
-
-## Step 1 — Authenticate
-
-### Option 1 — OAuth Device Grant (recommended)
-
-Run this once per machine to store your credentials in `~/.config/nexvora/config.json`:
-
-```bash
-npx @nexvora/mcp-server login
-```
-
-Follow the browser prompt to authorise. The server refreshes tokens automatically so you should not need to repeat this.
-
-### Option 2 — Personal Access Token
-
-If you cannot run an interactive browser flow (CI, headless servers, shared dev boxes), use a PAT instead:
-
-1. Open **https://app.nxvora.online/app/settings/mcp-tokens**.
-2. Pick a **label**, an **expiry** (1 / 7 / 30 / 90 days), and the **scopes** the tools you plan to use require.
-3. Click **Create token** and copy the resulting `nxv_pat_...` string — it is shown **once**.
-4. Paste it as `NEXVORA_ACCESS_TOKEN` in the `env` block of your `mcp.json` (see Step 2):
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_ACCESS_TOKEN": "nxv_pat_..."
-      }
-    }
-  }
-}
-```
-
-The server auto-detects PATs by the `nxv_pat_` prefix — no other config change is needed. PATs do not auto-refresh; rotate them before they expire.
-
-## Step 2 — Add the server to Claude Code
-
-Claude Code reads MCP server configuration from two locations. Choose the one that fits your workflow:
-
-### Global (all projects)
-
-Create or edit `~/.claude/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"]
-    }
-  }
-}
-```
-
-### Per-project
-
-Create or edit `.claude/mcp.json` at the root of the repository:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"]
-    }
-  }
-}
-```
-
-Commit this file to share the configuration with your team.
-
-## Step 3 — Verify
-
-Start (or restart) Claude Code, then ask:
-
-```
-What NexVora tools do you have access to?
-```
-
-You should see a list of all 12 `nexvora_*` tools. Try a quick health check:
-
-```
-Check my NexVora wallet balance.
-```
-
-## Environment overrides
-
-Add an `env` object to the server entry for environment-specific settings:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_API_URL": "https://staging.api.nxvora.online"
-      }
-    }
-  }
-}
-```
-
-## Using a local checkout instead of npm
-
-If you are developing the server itself or need an unreleased version:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "node",
-      "args": ["/absolute/path/to/nexvora-backend/mcp-server/dist/index.js"]
-    }
-  }
-}
-```
-
-Run `npm run build` inside `mcp-server/` after any code changes.
-
-The same `env` block and token rules apply for the local-checkout path — set `NEXVORA_ACCESS_TOKEN` (PAT) or run `npx @nexvora/mcp-server login` (OAuth) exactly as for the npm path.
-
-## Troubleshooting
-
-**Tools do not appear after configuration**
-- Run `npx @nexvora/mcp-server` in a terminal to check for startup errors.
-- Confirm that `node --version` prints 18 or above.
-- On Windows, use the full path to `node.exe` if `npx` is not on `PATH` inside Claude Code.
-
-**"Not authenticated" errors**
-- Re-run `npx @nexvora/mcp-server login`.
-
-**"Your NexVora PAT was rejected — it has been revoked or expired"**
-- You're using a Personal Access Token and it's no longer valid. PATs do not auto-refresh — generate a new one at **https://app.nxvora.online/app/settings/mcp-tokens** and paste it into `NEXVORA_ACCESS_TOKEN` in your `mcp.json`.
-
-**"Your NexVora PAT is missing the required scope: `tool:...`"**
-- The PAT you're using does not include the scope the tool needs. The exact missing scope is in the error. Generate a new PAT with that scope ticked at **https://app.nxvora.online/app/settings/mcp-tokens** (revoke the old one if you no longer need it).
-
-**Multiple NexVora accounts**
-- Set `NEXVORA_CONFIG_PATH` to a different file path in the `env` block to point each project at a different credential file.

package/docs/setup/cursor.md

@@ -1,129 +0,0 @@
-# Installing @nexvora/mcp-server in Cursor
-
-This guide adds the NexVora MCP server to [Cursor](https://cursor.sh/) so the 12 NexVora platform tools are available in Cursor's AI chat.
-
-## Prerequisites
-
-- Cursor 0.40 or later (MCP support was introduced in 0.40)
-- Node.js ≥ 18 on `PATH`
-- A NexVora account (free tier or above)
-
-## Step 1 — Authenticate
-
-### Option 1 — OAuth Device Grant (recommended)
-
-Run this once per machine to store your credentials:
-
-```bash
-npx @nexvora/mcp-server login
-```
-
-### Option 2 — Personal Access Token
-
-If you cannot run an interactive browser flow (CI, headless servers, shared dev boxes), use a PAT instead:
-
-1. Open **https://app.nxvora.online/app/settings/mcp-tokens**.
-2. Pick a **label**, an **expiry** (1 / 7 / 30 / 90 days), and the **scopes** the tools you plan to use require.
-3. Click **Create token** and copy the resulting `nxv_pat_...` string — it is shown **once**.
-4. Paste it as `NEXVORA_ACCESS_TOKEN` in the `env` block of your `mcp.json` (see Step 3):
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_ACCESS_TOKEN": "nxv_pat_..."
-      }
-    }
-  }
-}
-```
-
-The server auto-detects PATs by the `nxv_pat_` prefix — no other config change is needed. PATs do not auto-refresh; rotate them before they expire.
-
-## Step 2 — Open Cursor MCP settings
-
-1. Press `Cmd/Ctrl + Shift + P` and search for **"Open MCP Settings"**, or
-2. Go to **Cursor Settings → Features → MCP**.
-
-## Step 3 — Add the server
-
-In the MCP settings panel, click **Add new MCP server** and fill in:
-
-| Field | Value |
-|-------|-------|
-| Name | `nexvora` |
-| Type | `command` |
-| Command | `npx` |
-| Args | `-y @nexvora/mcp-server` |
-
-Or edit `~/.cursor/mcp.json` directly:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"]
-    }
-  }
-}
-```
-
-### Per-project configuration
-
-Create `.cursor/mcp.json` at the root of your repository to scope the server to that project:
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"]
-    }
-  }
-}
-```
-
-## Step 4 — Restart and verify
-
-1. Reload the Cursor window (`Cmd/Ctrl + Shift + P` → **Reload Window**).
-2. Open the Cursor Chat panel.
-3. Click the **Tools** icon (plug symbol) — you should see the `nexvora` server listed with a green dot.
-4. Test: ask Cursor to check your wallet balance.
-
-## Environment overrides
-
-```json
-{
-  "mcpServers": {
-    "nexvora": {
-      "command": "npx",
-      "args": ["-y", "@nexvora/mcp-server"],
-      "env": {
-        "NEXVORA_API_URL": "https://staging.api.nxvora.online"
-      }
-    }
-  }
-}
-```
-
-## Troubleshooting
-
-**Server shows a red dot / error state**
-- Open Cursor's developer console (`Help → Toggle Developer Tools`) and check the MCP log tab.
-- Run `npx @nexvora/mcp-server` directly in a terminal to isolate startup errors.
-
-**"Not authenticated" errors**
-- Re-run `npx @nexvora/mcp-server login` and reload the window.
-
-**"Your NexVora PAT was rejected — it has been revoked or expired"**
-- You're using a Personal Access Token and it's no longer valid. PATs do not auto-refresh — generate a new one at **https://app.nxvora.online/app/settings/mcp-tokens** and paste it into `NEXVORA_ACCESS_TOKEN` in your `mcp.json`.
-
-**"Your NexVora PAT is missing the required scope: `tool:...`"**
-- The PAT you're using does not include the scope the tool needs. The exact missing scope is in the error. Generate a new PAT with that scope ticked at **https://app.nxvora.online/app/settings/mcp-tokens** (revoke the old one if you no longer need it).
-
-**Windows: `npx` not found**
-- Use the full path to `npx.cmd` or install Node.js and ensure `%AppData%\npm` is on `PATH`.