Upmind MCP Server

A Model Context Protocol (MCP) server for interacting with the Upmind API. This server provides comprehensive tools for managing products, categories, pricing, bundles, and more within the Upmind platform.

Features

• Product Management: Create, read, update, and delete products

• Category Management: Manage product categories

• Pricing Control: Set and manage product pricing across different billing cycles

• Bundle Creation: Create and manage product bundles/sets

• Generic API Access: Direct access to any Upmind API endpoint

• Environment Variable Configuration: Secure credential management

Available Tools

Product Tools

• list_products - List all products for the current brand

• get_product - Get a specific product by ID

• create_product - Create a new product

• update_product - Update an existing product

• delete_product - Delete a product by ID

Category Tools

• list_categories - List all product categories

• get_category - Get a specific category by ID

• create_category - Create a new product category

• update_category - Update an existing category

• delete_category - Delete a category by ID

Pricing Tools

• set_product_pricing - Set pricing for a product in a pricelist

• get_product_pricing - Get pricing for a product from pricelist

Bundle Tools

• create_bundle - Create a product bundle

• add_products_to_bundle - Add products to a bundle/set

• remove_product_from_bundle - Remove a product from a bundle/set

Generic API Tools

• api_get - Make GET requests to any Upmind API endpoint

• api_post - Make POST requests to any Upmind API endpoint

• api_put - Make PUT requests to any Upmind API endpoint

• api_delete - Make DELETE requests to any Upmind API endpoint

Installation

1. Clone this repository:

git clone <repository-url>
cd upmind-mcp

2. Install dependencies:

pip install -r requirements.txt

3. Copy the example configuration:

cp mcp_config.json.example mcp_config.json

4. Edit mcp_config.json and update the configuration:

{
  "mcpServers": {
    "upmind-api": {
      "command": "python",
      "args": ["/path/to/upmind-mcp/upmind_mcp.py"],
      "env": {
        "UPMIND_API_KEY": "your_upmind_api_key_here",
        "UPMIND_BRAND_ID": "your_brand_id_here"
      }
    }
  }
}

5. Add the server to your MCP client configuration (e.g., Claude Desktop)

Configuration

Required Environment Variables

Set these in the env section of your MCP configuration:

• UPMIND_API_KEY: Your Upmind API JWT token

• UPMIND_BRAND_ID: Your Upmind brand ID

Getting Your Credentials

1. API Key: Generate a JWT token from your Upmind admin panel

2. Brand ID: Found in your Upmind brand settings (UUID format)

Usage Examples

Create a Product

# Use the create_product tool
{
  "name": "Web Hosting Plan",
  "category_id": "category-uuid",
  "billing_cycle_months": 1,
  "description": "Premium web hosting with 5GB storage"
}

Set Product Pricing

# Use the set_product_pricing tool
{
  "product_id": "product-uuid",
  "prices": [
    {
      "billing_cycle_months": 1,
      "price": 7.00,
      "currency_id": 1
    },
    {
      "billing_cycle_months": 12,
      "price": 75.60,
      "currency_id": 1
    }
  ]
}

Create a Bundle

# Step 1: Create bundle product
{
  "name": "Annual Hosting Bundle",
  "category_id": "category-uuid",
  "billing_cycle_months": 12
}

# Step 2: Add products to bundle
{
  "bundle_id": "bundle-product-uuid",
  "products": [
    {"product_id": "hosting-product-uuid"},
    {"product_id": "domain-product-uuid"}
  ]
}

API Reference

For complete API documentation, see the Upmind API documentation included in docs/REST.json.

Limitations

• Currently focused on admin/brand-level operations

• Requires valid Upmind API credentials

• Limited to the Upmind API's capabilities and rate limits

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues related to:

• This MCP Server: Open an issue in this repository

• Upmind API: Contact Upmind support

• MCP Protocol: See MCP documentation