Ned AI MCP Server

Model Context Protocol server that connects your Ned AI store analytics to AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients.

Quick Setup (Claude Desktop)

npx @ned-ai/mcp-server install --api-key YOUR_API_KEY

Then restart Claude Desktop. Done!

Once restarted, ask Claude: "What were my sales today?"

Uninstall

npx @ned-ai/mcp-server uninstall

Then restart Claude Desktop to complete removal.

Advanced Setup (Manual Config)

If you prefer to configure manually, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "ned": {
      "command": "npx",
      "args": ["-y", "@ned-ai/mcp-server"],
      "env": {
        "NED_API_KEY": "ned_live_your_key_here"
      }
    }
  }
}

Config file locations:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cursor Setup

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "ned": {
      "command": "npx",
      "args": ["-y", "@ned-ai/mcp-server"],
      "env": {
        "NED_API_KEY": "ned_live_your_key_here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
NED_API_KEY	Yes	Your Ned API key (starts with ned_live_)
NED_API_BASE_URL	No	Custom API base URL (default: https://api.meetned.com)

Available Tools

Tool	Description
get_sales_context	Sales analytics: revenue, orders, AOV, customer metrics with period comparison
get_profitability_metrics	Profitability: gross profit, margins, COGS coverage
get_customer_segments	Customer segments by profit tier or activity tier
get_marketing_metrics	Marketing efficiency: MER, CAC, ROAS

Requirements

• Node.js 18+
• A Ned API key (get one at meetned.com)

License

MIT