Any MCP Client

Connect Ned to any tool that supports the Model Context Protocol.

What You'll Need

• An MCP-compatible AI tool
• A Ned AI API key
• Node.js 18+ installed

Step 1: Get Your API Key

1. Go to app.meetned.com
2. Open Settings → Developer
3. Click Create API Key
4. Copy the key

Step 2: Add the Ned Server

TIP

Claude Desktop users: You can skip the manual config and run this instead:

npx @ned-ai/mcp-server@latest install --api-key ned_live_YOUR_API_KEY_HERE

Then restart Claude Desktop. To remove later: npx @ned-ai/mcp-server@latest uninstall

For other MCP clients, find your config file. Common locations:

Tool	Config Location
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (Mac)
Claude Code	.mcp.json in project root
Cursor	.cursor/mcp.json in project root
Windsurf	~/.codeium/windsurf/mcp_config.json

Step 3: Add to Config (Manual)

Add this to your MCP config:

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

TIP

If your config file already has other servers, add the "ned" entry inside the existing "mcpServers" object.

Step 4: Restart Your Tool

Most MCP clients require a restart to pick up config changes. Restart your tool and verify that "ned" appears in the list of connected servers.

Step 5: Try It Out

Ask your AI assistant:

• "What are my sales today?"
• "How did last week compare to the week before?"
• "What's my gross margin this month?"
• "Which products are most profitable?"
• "How is my ad spend performing?"

Available Tools

Once connected, the Ned MCP server provides these tools:

Tool	Description
get_sales_context	Sales metrics for any time period
get_profitability	Profit margins and COGS breakdown
get_customer_summary	Customer analytics and segments
get_marketing_metrics	MER, CAC, ROAS, and ad performance
get_forecast	Revenue projections (Growth tier)

Troubleshooting

Server doesn't start

Verify the package is accessible:

npx @ned-ai/mcp-server --version

If that fails, install it globally:

npm install -g @ned-ai/mcp-server

Then update your config to use the global path:

{
  "mcpServers": {
    "ned": {
      "command": "ned-mcp-server",
      "env": {
        "NED_API_KEY": "ned_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

"Authentication failed"

• Verify your API key starts with ned_live_
• Check for extra spaces around the key
• Make sure the key hasn't been revoked in Settings → Developer

Need Help?

• GitHub Issues
• Ned Support