d365-csu 0.1.0

Python MCP tool for D365 Commerce Scale Unit REST APIs

d365-csu

Python MCP tool for D365 Commerce Scale Unit (CSU) REST APIs.

Provides CRUD operations against CSU endpoints and a built-in catalog of available endpoints with sample JSON payloads.

Installation

pip install -e .

Configuration

Set the following environment variables:

Variable	Description
CSU_BASE_URL	CSU base URL (e.g. https://myhost.commerce.dynamics.com/Commerce)
CSU_OUN	Operating Unit Number
AZURE_TENANT_ID	Azure AD tenant ID
AZURE_CLIENT_ID	App registration client ID
AZURE_CLIENT_SECRET	App registration client secret
AZURE_RESOURCE_ID	CSU resource ID for token scope

Usage

As an MCP Tool

Add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "d365-csu": {
      "command": "d365-csu",
      "env": {
        "CSU_BASE_URL": "https://myhost.commerce.dynamics.com/Commerce",
        "CSU_OUN": "128",
        "AZURE_TENANT_ID": "your-tenant-id",
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_CLIENT_SECRET": "your-client-secret",
        "AZURE_RESOURCE_ID": "your-resource-id"
      }
    }
  }
}

Browse Endpoints (no credentials needed)

from d365_csu.endpoints import list_endpoints, get_sample_payload, list_entities

# List all supported entities
print(list_entities())
# ['Carts', 'Categories', 'Customers', 'OrgUnits', 'Products', 'SalesOrders']

# List all endpoints for an entity
for ep in list_endpoints("Customers"):
    print(f"{ep['method']} {ep['path']} — {ep['description']}")

# Get a sample request body
payload = get_sample_payload("Customers", "Search")
print(payload)

Direct Python Usage

from d365_csu.auth import AzureADAuth
from d365_csu.client import CSUClient
from d365_csu.entities import customers, products

auth = AzureADAuth(
    tenant_id="...",
    client_id="...",
    client_secret="...",
    resource_id="...",
)
client = CSUClient("https://myhost.commerce.dynamics.com/Commerce", "128", auth)

# Search customers
results = customers.search_customers(client, "contoso")

# Search products
results = products.search_products(client, "laptop")

Available MCP Tools

Tool	Description
csu_list_endpoints	List available CSU endpoints with sample payloads
csu_list_entities	List supported entity names
csu_get_sample_payload	Get sample JSON body for an endpoint
csu_search_customers	Search customers by keyword
csu_create_customer	Create a new customer
csu_search_products	Search product catalog
csu_get_product	Get a product by ID
csu_manage_cart	Cart operations (create, add lines, checkout)
csu_search_orders	Search sales orders
csu_get_stores	Get org units / stores
csu_get_categories	Get category hierarchy
csu_raw_request	Make a raw CSU API call