MCP Server

Connect Ned AI to Claude Desktop and other AI assistants using the Model Context Protocol (MCP).

What is MCP?

The Model Context Protocol allows AI assistants like Claude to access external tools and data sources. With the Ned MCP server, you can ask natural language questions about your Shopify data.

Quick Install (Claude Desktop)

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

Then restart Claude Desktop. That's it!

To remove: npx @ned-ai/mcp-server@latest uninstall

Supported Platforms

Set up Ned with your AI tool of choice:

Platform	Guide
Claude Desktop	Step-by-step setup →
Claude Code (CLI)	Step-by-step setup →
Cursor	Step-by-step setup →
Windsurf	Step-by-step setup →
OpenClaw	ClawHub skill install →
ChatGPT	Custom GPT setup →
Lovable	SDK integration →
Any MCP Client	Generic setup →

See all platform guides →

Available Tools

Once connected, your AI assistant can use these tools:

get_sales_context

Get sales metrics for a time period.

Example prompts:

• "What are my sales today?"
• "How did last week compare to the week before?"
• "Show me my top products this month"

get_profitability

Get profit metrics and product profitability.

Example prompts:

• "What's my gross margin this month?"
• "Which products are most profitable?"
• "Show me my profitability summary"

get_customer_summary

Get customer analytics and segments.

Example prompts:

• "How many new customers did I get this week?"
• "What's my average customer lifetime value?"
• "Show me customer segments"

get_marketing_metrics

Get marketing efficiency metrics.

Example prompts:

• "What's my MER for the last 30 days?"
• "How is my ad spend performing?"
• "Show me ROAS by channel"

get_forecast (Growth tier)

Get revenue forecasts.

Example prompts:

• "What's my projected revenue for next month?"
• "Show me the sales forecast"

Example Conversations

Daily Check-in

You: How's business doing today?

Claude: Let me check your sales data...

Today you've made $1,234 in revenue from 12 orders, with an average order value of $102.83. That's up 15% compared to yesterday.

Your top seller today is the "Premium Widget" with 4 units sold.

Weekly Analysis

You: Give me a summary of last week's performance

Claude: Here's your weekly summary:

Revenue: $8,450 (↑ 12% vs prior week) Orders: 67 (↑ 8%) AOV: $126.12 (↑ 4%)

Top Products:

1. Premium Widget - $2,100
2. Standard Widget - $1,450
3. Widget Accessory Pack - $890

Your MER was 4.2, meaning you made $4.20 for every $1 spent on ads.

Marketing Deep Dive

You: How are my Meta ads performing?

Claude: Your Meta ads over the last 30 days:

Spend: $5,200 Revenue: $19,800 ROAS: 3.81

Your best performing campaign is "Summer Sale 2025" with a 4.2 ROAS. The "Lookalike - Purchasers" ad set is outperforming your interest-based targeting.

Troubleshooting

"MCP server not found"

Make sure npx can find the package:

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

"Authentication failed"

1. Verify your API key is correct
2. Check the key hasn't been revoked
3. Ensure no extra spaces in the config

"Tool call failed"

Check your AI tool's logs for details. For Claude Desktop:

• macOS: ~/Library/Logs/Claude/
• Windows: %APPDATA%\Claude\logs\

Need help?

• GitHub Issues
• Ned Support