nado-dev-mcp

MCP server for Nado developer documentation, integration guidance, and customer support tooling. Two personas — Tech Lead for development and Support for debugging — backed by 28 documentation resources and 13 tools.

Works with Cursor, Claude Desktop, VS Code, Windsurf, Codex, Gemini CLI, and any MCP-compatible client.

Contents

• Personas
• Installation
• MCP Client Setup
• Environment Variables
• Tools
• Resources
• Development

Personas

Tech Lead (techLead, default)

Senior technical leader helping engineers build on the Nado protocol. Covers SDK development, frontend patterns, and builder integration. Provides working code, flags gotchas, and recommends architecture.

Customer Support (support)

Diagnoses user issues with live account data. Looks up subaccounts, linked signers, positions, orders, and liquidations. Replies directly to users — concise, friendly, answer-first.

Switch personas at runtime with the set_persona tool, or set a default via the NADO_PERSONA environment variable.

Installation

No manual install needed. MCP clients resolve the package automatically when configured with npx (see below).

MCP Client Setup

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "nado-dev": {
      "command": "npx",
      "args": ["@nadohq/nado-dev-mcp"],
      "env": {
        "DATA_ENV": "nadoMainnet"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "nado-dev": {
      "command": "npx",
      "args": ["@nadohq/nado-dev-mcp"],
      "env": {
        "DATA_ENV": "nadoMainnet"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | | -------------- | -------- | ------------- | ---------------------------------------- | | DATA_ENV | No | nadoMainnet | nadoMainnet or nadoTestnet | | RPC_URL | No | Chain default | Custom RPC endpoint | | NADO_PERSONA | No | techLead | Default persona: techLead or support |

Tools

Developer Tools

| Tool | Description | | --------------------- | ----------------------------------------------------------------- | | search_docs | Full-text fuzzy search across all 28 documentation resources | | get_code_example | Retrieve complete documentation for a topic by slug | | get_sdk_method_info | Look up SDK method signatures by domain and/or name | | set_persona | Switch between techLead and support personas mid-conversation |

Support Tools

| Tool | Description | | ----------------------- | ----------------------------------------------------------------- | | lookup_subaccount | Check subaccount existence, balances, and health | | check_linked_signer | Verify linked signer status and rate limits | | lookup_market | Resolve product IDs to symbols and market details | | lookup_positions | Get open cross and isolated positions | | lookup_orders | Get open engine and trigger orders | | lookup_order_history | Get historical order data from the indexer | | lookup_liquidations | Get historical liquidation events | | lookup_account_events | Comprehensive wallet audit across all event streams | | diagnose_account | Run full account diagnostic (balances, signer, positions, orders) |

Resources

Guides (nado-dev://guides/*)

| Resource | Description | | ------------------- | ---------------------------------------------------------------------- | | getting-started | Install SDK, create client, first query, first order | | client-setup | createNadoClient options, chain envs, wallet config, linked signers | | protocol-concepts | Products, margin, health, funding, price types, subaccounts, NLP vault | | react-integration | NadoClientContext, query/execute hooks, TanStack Query patterns |

Topics (nado-dev://topics/*)

| Resource | Description | | -------------------------- | ----------------------------------------------------------------------- | | internal-gotchas | High-signal pitfalls: signing, order building, margin, timing, encoding | | placing-orders | Market, limit, post-only, reduce-only, isolated, builder fee orders | | positions-and-pnl | Position fetching, PnL calculation, entry price, liquidation | | market-data | Prices, candlesticks, funding rates, tickers, liquidity | | subaccounts | Summary, health, isolated positions, fee rates | | collateral-and-deposits | Deposit, withdraw, transfer, approvals | | trigger-orders | Stop-loss, take-profit, TWAP, combined TP/SL | | websockets | Real-time streaming, subscriptions, message builders | | nlp-vault | Mint/burn NLP, pool info, locked balances | | common-errors | Engine error codes, silent failures, troubleshooting | | builder-integration | Builder code fees, appendix encoding, fee claiming | | frontend-patterns | Execute hooks, query keys, Jotai state, provider stack, WebSockets | | linked-signer-deep-dive | Key derivation, link payload, sign fallback, linkSignerWithReset | | referrals | Referral program, invite codes, rewards, affiliate program | | order-building-internals | Appendix bit layout, nonces, expiration, EIP-712, TWAP | | contracts-and-architecture | Contract addresses, protocol constants, on-chain errors, architecture | | api-errors | Complete 100+ API error code reference (1000–5000) | | rate-limits | Weight-based rate limits, per-query/execute weights, trigger limits | | protocol-formulas | PnL, health, margin, leverage, liquidation, funding, portfolio formulas |

Reference (nado-dev://reference/*)

| Resource | Description | | --------------------- | ------------------------------------------------------------------ | | sdk-architecture | Package structure, class hierarchy, ts-mixer, context, data flow | | client-api | Complete method signatures for all API domains | | types-and-utilities | BigDecimal, types, utility functions, constants | | codebase-map | Cross-repo file map: SDK, frontend, CLI, MCP | | official-docs-index | Canonical docs.nado.xyz URLs and external links |

Development

git clone https://github.com/nadohq/nado-dev-mcp.git && cd nado-dev-mcp
bun install
bun run build

bun run dev        # Watch mode
bun run build      # Build for production
bun run typecheck  # Type check
bun run lint       # Lint and format