Brightshot MCP Server

A Model Context Protocol (MCP) server that provides AI-powered real estate photo enhancement capabilities through the Brightshot API.

Features

This MCP server exposes the following tools for AI-powered image transformation:

| Tool | Description | |------|-------------| | stage | Virtual staging - Add furniture to empty rooms | | enhance | Enhance photo quality, color, and lighting | | upscale | Improve image resolution | | edit | Edit images using natural language | | restyle | Change interior design style | | empty_room | Remove all furniture from a room | | remove | Remove specific objects | | blur | Blur objects for privacy | | lighting | Adjust lighting and mood | | window_view | Change window views | | clear_sky | Fix cloudy skies in exterior photos | | sketch | Convert sketches to photorealistic renders | | floor_plan | Convert floor plans to 3D renders | | generate | Generate interiors from text descriptions | | inpaint | Edit specific areas using a mask | | get_prediction | Check prediction status | | get_account | Get account info and remaining credits |

Installation

NPX (Recommended)

npx @brightshot/mcp

Manual Installation

npm install -g @brightshot/mcp

Configuration

Get your API Key

1. Sign up at bright-shot.com
2. Go to Settings → API Keys
3. Create a new API key

Claude Desktop

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "brightshot": {
      "command": "npx",
      "args": ["@brightshot/mcp"],
      "env": {
        "BRIGHTSHOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BRIGHTSHOT_API_KEY | Yes | Your Brightshot API key | | BRIGHTSHOT_API_URL | No | Custom API URL (defaults to https://api.bright-shot.com/api/v1) |

Usage Examples

Once configured, you can use the tools in Claude:

Virtual Staging

"Stage this empty room with modern furniture: https://example.com/empty-room.jpg"

Photo Enhancement

"Enhance the quality of this real estate photo: https://example.com/photo.jpg"

Natural Language Editing

"Change the sofa to blue in this image: https://example.com/living-room.jpg"

Object Removal

"Remove the car from this exterior photo: https://example.com/house.jpg"

Style Change

"Restyle this room to Scandinavian design: https://example.com/room.jpg"

How It Works

1. You provide an image URL and describe what you want
2. The MCP server sends the request to Brightshot's API
3. The API processes the image asynchronously
4. Use get_prediction with the returned requestId to check status and get results
5. When complete, you receive the URL of the transformed image

Development

# Clone the repository
git clone https://github.com/BrightShotApp/brightshot-mcp.git
cd brightshot-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
BRIGHTSHOT_API_KEY=your-key node dist/index.js

License

MIT

Links

• Brightshot Website
• API Documentation
• Model Context Protocol