# @nexus-finance/mcp

MCP server for the **Nexus Finance** API v1 — connect Claude Desktop, Claude Code, Cursor or any MCP-compatible client to financial contract analysis, risk analytics, market quotes and compliance case management.

> **What is this?** Connect your Claude to Nexus Finance in 30 seconds. From that point, Claude can invoke contract audits, VaR/CVaR calculations, Basel III RWA, live market quotes, OFAC screening and compliance case management without leaving the conversation.

---

## Quick install

### 1. Get an API key

Log in at [app.nexusquantum.finance](https://app.nexusquantum.finance) → **Settings → API Keys** → create a key. Copy the `nf_...` key — shown only once.

### 2. Configure your client

#### Claude Desktop (macOS / Windows)

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "nexus-finance": {
      "command": "npx",
      "args": ["-y", "@nexus-finance/mcp"],
      "env": {
        "NEXUS_FINANCE_API_KEY": "nf_YOUR_KEY_HERE"
      }
    }
  }
}
```

Restart Claude Desktop. You'll see a 🔌 icon in the chat with the 8 Nexus Finance tools available.

#### Claude Code (CLI)

```bash
claude mcp add nexus-finance -- npx -y @nexus-finance/mcp
# Then set your key:
export NEXUS_FINANCE_API_KEY=nf_YOUR_KEY_HERE
```

#### Cursor

Edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "nexus-finance": {
      "command": "npx",
      "args": ["-y", "@nexus-finance/mcp"],
      "env": {
        "NEXUS_FINANCE_API_KEY": "nf_YOUR_KEY_HERE"
      }
    }
  }
}
```

### 3. Try it

In Claude Desktop, type:

> Audit this contract with Nexus Finance and flag any high-risk clauses: «[paste contract text here]»

Claude will automatically call `nexus_analyze` and return a full risk assessment with severity-rated findings.

---

## The 8 tools

| Tool | Description | Typical cost |
|---|---|---|
| `nexus_analyze` | Contract audit, commodity briefing, playbook or CCC compliance review. Zero Retention. | 1–3 credits |
| `nexus_var_calculator` | Parametric VaR / CVaR at 90/95/99% confidence + 5-scenario stress test + VaR matrix | 1 credit |
| `nexus_rwa_calculator` | Basel III Standardized Approach RWA across all asset classes + capital adequacy check | 1 credit |
| `nexus_market_quote` | Real-time equity, FX or commodity quote (Alpha Vantage, 15-min cache) | Free |
| `nexus_bulk_quotes` | Up to 10 quotes in one call | Free |
| `nexus_list_cases` | List compliance cases (paginated, filterable by status) | Free |
| `nexus_get_case` | Full case detail with findings and counterparties | Free |
| `nexus_create_case` | Create a new compliance case | Free |

---

## Environment variables

| Variable | Required | Description |
|---|---|---|
| `NEXUS_FINANCE_API_KEY` | ✅ Yes | API key starting with `nf_` |
| `NEXUS_FINANCE_BASE_URL` | ❌ No | Override API base URL (default: `https://app.nexusquantum.finance`) |

---

## What Nexus Finance covers

- **Contract Intelligence** — audit, redlining, AI drafting, obligation extraction, clause benchmark, RAG chat
- **Regulatory Compliance** — EMIR/REMIT XML, CBAM, EUDR, CSDDD, MiFID II alerts, CCC v4.2
- **Risk Analytics** — VaR/CVaR, RWA Basel III, stress tests, TBML watchdog, dynamic risk matrix
- **Counterparty Due Diligence** — KYB/UBO graph (GLEIF + OpenCorporates), OFAC screening, vessel IMO screening
- **Case Management** — 4-eyes workflow, multi-tenancy, audit export, rules engine

All analysis is **Zero Retention** — document text is never stored, logged or persisted.

---

## Links

- 🌐 Platform: [nexusquantum.finance](https://nexusquantum.finance)
- 📦 npm: [@nexus-finance/mcp](https://www.npmjs.com/package/@nexus-finance/mcp)
- 🐍 Python SDK: [nexus-finance-sdk](https://pypi.org/project/nexus-finance-sdk/)
- 📚 TypeScript SDK: [@nexus-finance/sdk](https://www.npmjs.com/package/@nexus-finance/sdk)

---

## License

MIT © [Quantum Nexus Ventures FZCO](https://nexusquantum.finance)