sundr-mcp

Sundr MCP Server

MCP (Model Context Protocol) server that exposes Sundr's repair-vs-replace decision engine to AI agents like Claude.

"Should I repair my iPhone or buy a new one?" - Let AI help you decide with data-driven recommendations, repair costs, local shops, and environmental impact.

What is this?

When you ask an AI assistant "Should I repair my iPhone?", this MCP server enables the AI to:

• Call Sundr's decision engine for a data-driven recommendation
• Return repair cost estimates, local repair shops, and environmental impact
• Include affiliate links for parts, repair services, and alternatives

All responses include actionable links for buying parts, booking repairs, or purchasing refurbished devices.

Quick Start

# One-line install and test
npx sundr-mcp

Then ask Claude: "Should I repair my iPhone 13 with a cracked screen?"

Installation

For Claude Desktop

Add to your Claude Desktop config:

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

{
  "mcpServers": {
    "sundr": {
      "command": "npx",
      "args": ["sundr-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "sundr": {
      "command": "sundr-mcp"
    }
  }
}

For Claude Code (CLI)

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "sundr": {
      "command": "npx",
      "args": ["sundr-mcp"]
    }
  }
}

For VS Code with Copilot

MCP servers can be added via the VS Code MCP server registry. Search for "sundr" in the Extensions view.

Manual Installation

npm install -g sundr-mcp

From Source

git clone https://github.com/KeithWyatt/sundr.git
cd sundr/sundr-mcp
npm install
npm run build
npm link

Available Tools (27 total)

Core Tools (7)

Tool	Description
should_repair	Main decision engine - repair, replace, or sell?
find_repair_shops	Find local repair shops with ratings
get_device_info	Look up device repairability scores
compare_options	Compare repair vs refurbished vs new
trade_in_value	Get trade-in and sell values
environmental_impact	CO2 and e-waste impact analysis
repair_cost_estimate	Get repair cost estimates (DIY vs pro)

Tool Aliases (20)

For better discoverability, the same functionality is exposed under multiple names:

Repair Decision Aliases:

• repair_decision, repair_or_replace, fix_or_buy_new, is_repair_worth_it

Compare Options Aliases:

• repair_vs_replace, repair_vs_new

Device Info Aliases:

• device_repairability, ifixit_score, can_i_fix_it

Find Shops Aliases:

• phone_repair_near_me, where_to_fix_device

Trade-In Aliases:

• sell_my_device, device_worth, apple_trade_in

Environmental Aliases:

• carbon_footprint, eco_friendly_choice, ewaste_impact

Repair Cost Aliases:

• how_much_to_fix, screen_repair_cost, battery_replacement_cost

Prompts

Pre-configured conversation starters:

Prompt	Description
repair_advisor	Personalized repair-vs-replace advice
trade_in_advisor	Compare trade-in offers
eco_impact	Environmental impact analysis
repair_cost	Repair cost estimates
find_repair_shop	Find local repair shops

Tool Examples

should_repair

Get a repair recommendation for a device.

Example prompt: "Should I repair my iPhone 13 Pro with a cracked screen?"

Input:

{
  "device": "iPhone 13 Pro",
  "issue": "cracked screen",
  "category": "smartphone",
  "repair_cost_estimate": 279,
  "device_age_months": 24,
  "location": "Vancouver, BC"
}

Output includes:

• Recommendation (REPAIR/REPLACE) with confidence score
• Reasoning and cost analysis
• CO2 saved by repairing
• Actionable links for parts, repair shops, refurbished alternatives
• DIY and professional repair options with pricing

trade_in_value

Get trade-in and resale values for your device.

Example prompt: "How much is my iPhone 12 worth?"

Input:

{
  "device": "iPhone 12",
  "condition": "good"
}

Output includes:

• Estimated value range
• Offers from Apple, Decluttr, Gazelle, Swappa, eBay
• Pros/cons of each selling option
• Direct links to sell

environmental_impact

Calculate environmental impact of repair vs replace.

Example prompt: "What's the carbon footprint of buying a new laptop?"

Input:

{
  "device": "laptop",
  "category": "laptop"
}

Output includes:

• CO2 emissions for manufacturing vs repair
• E-waste prevented by repairing
• Equivalent comparisons (miles driven, trees needed)
• Sustainability recommendations

repair_cost_estimate

Get detailed repair cost estimates.

Example prompt: "How much does it cost to replace a MacBook Pro screen?"

Input:

{
  "device": "MacBook Pro",
  "issue": "screen",
  "category": "laptop"
}

Output includes:

• DIY parts cost range
• Professional repair cost range
• Difficulty rating and time estimate
• Links to buy parts and find repair shops

find_repair_shops

Find local repair shops near a location.

Example prompt: "Find phone repair shops near me in Seattle"

Input:

{
  "location": "Seattle, WA",
  "device_type": "smartphone",
  "radius_km": 10
}

get_device_info

Look up repairability information for a device.

Example prompt: "What's the repairability score for MacBook Pro 2021?"

Input:

{
  "query": "MacBook Pro 2021"
}

compare_options

Compare repair vs refurbished vs new side-by-side.

Example prompt: "Compare my options for a MacBook Pro with a dead battery"

Input:

{
  "device": "MacBook Pro 2019",
  "issue": "battery",
  "category": "laptop",
  "device_age_years": 4
}

Resources

Device Catalog

Browse the device repairability database:

• sundr://devices/catalog - Overview and categories
• sundr://devices/search/{query} - Search devices
• sundr://devices/brand/{brand} - List devices by brand

Environment Variables

Variable	Default	Description
SUNDR_API_URL	https://www.sundr.ca	Sundr API base URL

Affiliate Links

All product and parts links use Sundr's redirect system:

https://www.sundr.ca/go/{product_id}?ref=mcp

This enables:

• Attribution tracking for MCP-originated conversions
• Affiliate revenue sharing with device repair content creators
• Analytics on AI assistant usage patterns

Every tool response includes an action_links object with relevant affiliate links.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Test locally
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
echo '{"jsonrpc":"2.0","id":1,"method":"prompts/list"}' | node dist/index.js

Data Sources

• iFixit: Repairability scores, teardown guides, parts availability
• Sundr Database: Device models, repair costs, shop directory
• Environmental Data: CO2 estimates from academic research on electronics manufacturing

License

MIT

Links

• Sundr Website
• MCP Specification
• MCP TypeScript SDK