# 🧩 MakeSync MCP Server

An advanced Model Context Protocol (MCP) server for Make.com, enabling intelligent patching, scenario management, and integration with automation workflows.

**Author**: Nadav Daniel  
**License**: MIT  
**Project Version**: 1.0.0

> 🧠 Originally inspired by Eduard Litau’s [`mcp-server-make-dot-com`](https://github.com/elitau/mcp-server-make-dot-com)

---

## 🧠 Project Overview

This server implements a powerful and extensible MCP interface for interacting with the [Make.com API](https://www.make.com/en/api-documentation). Unlike basic implementations, `MakeSync MCP Server` is **module-agnostic**, capable of reading and updating scenario blueprints based on their declared `metadata.parameters`, `interface`, and `expect` structure.

It supports:

- Reading scenarios and their structure.
- Smart, spec-compliant patching of any module.
- CLI and Claude Desktop usage.
- Safe blueprint patching using `confirm` logic.
- Configurable environment and TypeScript support.

---

## 🔧 Features

- ✅ Read live or draft blueprint of any scenario
- ✏️ Smart patching of module fields based on metadata spec
- 🛡 Confirm logic to safely update scenarios
- 🔍 Auto-wrap `{{...}}` mappers if missing
- 🧠 Agnostic patching across any module type
- 🧰 Compatible with Claude Desktop, local node, and GitHub workflows

---

## 📦 Tools

### `read_make_dot_com_scenario_blueprint`

- **Inputs**:
  - `scenario_id` (number)
  - `draft` (boolean, optional)
- **Output**: Full blueprint JSON

### `update_make_dot_com_scenario`

- **Inputs**:
  - `scenario_id` (number)
  - `name` / `description` (optional)
  - `module_id` (optional): The module inside the flow to patch
  - `operations` (optional): List of `{ path, value }` patch instructions
  - `confirm` (boolean, default: `true`): Required for installing new apps
- **Behavior**:
  - Applies all updates based on Make.com module structure
  - Wraps `value` with `{{...}}` if appropriate
  - Validates against module `interface` and `parameters` keys

---

## 🔑 Required API Key Scopes

Ensure your API key includes the following scopes:

agents:read apps:read connections:read datastores:read devices:read functions:read scenarios:read scenarios:run scenarios:write teams:read

## ⚙️ Configuration

### Option 1: Quick Setup with Claude Desktop

Run the provided setup script or use:

```bash
MAKE_DOT_COM_API_KEY=xxx npm install && npm run build
```