Claude Desktop

Integrates Amoga Studio with Claude Desktop for enhanced productivity and communication.

GitHub

Amoga Studio MCP Server

MCP Server for Amoga Studio integration with Claude Desktop

A powerful Model Context Protocol (MCP) server that enables seamless integration between Claude Desktop and Amoga Studio's low-code application development platform. This server provides comprehensive tools for creating, managing, and deploying applications with advanced features like RBAC, automation, and AI-powered code generation.

Quick Setup (No Clone Required)

Add this server to your Claude Desktop configuration by adding one of the following configurations:

Using npx (Recommended):

{
  "mcpServers": {
    "amogastudio": {
      "command": "npx",
      "args": ["-y", "amogastudio"],
      "env": {
        "AMOGA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Using uvx:

{
  "mcpServers": {
    "amogastudio": {
      "command": "uvx",
      "args": ["amogastudio"],
      "env": {
        "AMOGA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Amoga Studio API key.

Manual Setup (For Development)

  1. Install dependencies:
npm install
  1. Build the server:
npm run build

Features & Capabilities

🚀 Application Management

  • Create, read, update, and delete applications
  • Get application contracts and configurations
  • Publish applications with status tracking

🏗️ Object & Data Modeling

  • Create objects with attributes, statuses, and relationships
  • Support for various data types (text, number, date, boolean, enumeration)
  • Advanced relationship modeling (oneToMany, manyToOne)

🔐 Advanced RBAC (Role-Based Access Control)

  • createRoleV1: AI-powered role creation with contract-aware permission mapping
  • Intelligent object matching with fuzzy logic
  • Granular permissions per role and object
  • Automatic default permission assignment

🤖 AI-Powered Automation

  • createAutomationV1: Natural language automation generation
  • Contract-aware script generation with Python code
  • Email templates and PDF generation
  • Complete workflow automation with trigger details

📊 Status Origination Trees (SOT)

  • Define status transitions and origination sources
  • Page layout generation with widget management
  • Workflow integration and automation triggers

🎨 UI & Navigation

  • Create navigation bars and page structures
  • Generate application pages with custom widgets
  • Support for dashboard and record page layouts

👥 User & Access Management

  • Job title creation and management
  • User creation with role assignments
  • Attribute management for data structures

Using with Claude Desktop

The server provides two tool categories:

Legacy Tools (Backward Compatibility)

  • create-app, get-apps, delete-app
  • create-object, create-sot, delete-object
  • create-update-roles, create-attributes
  • add-dummy-data, publish-app, check-publish-status

V1 Tools (Modern & AI-Enhanced)

  • createAppV1: Streamlined application creation
  • createSOTV1: Objects with attributes and SOT processing
  • createRoleV1: Advanced RBAC with intelligent permission mapping
  • createAutomationV1: AI-powered automation generation
  • publishV1: Simple application publishing

Example Usage

Once configured, you can interact with the server through Claude Desktop with natural language:

Application Management

  • "Create a new application called 'Inventory Management System'"
  • "Show me all my applications"
  • "Get the contract details for app ID 12345"

RBAC Setup

  • "Create roles for my app: Admin with full access, User with read-only access to products"
  • "Set up RBAC permissions where Manager can create and update orders but cannot delete them"

AI Automation

  • "When a new order is created, send email to the customer and create a follow-up task"
  • "Create automation that generates PDF invoice when order status changes to completed"

Object Creation

  • "Create a Product object with name, price, category, and stock quantity fields"
  • "Add status workflow to Task object: Todo → In Progress → Completed"

The server handles authentication automatically using the provided API key and provides intelligent suggestions based on your application contract.

Dependencies & Requirements

This package requires the following dependencies:

{
  "@modelcontextprotocol/sdk": "^1.11.1",
  "axios": "^1.10.0",
  "dotenv": "^16.5.0",
  "uuid": "^11.1.0",
  "zod": "^3.24.4"
}

Development dependencies:

  • TypeScript 5.8.3+
  • Node.js 18+
  • Cross-platform environment support

Configuration Options

The server accepts the following environment variables:

  • AMOGA_API_KEY (required): Your Amoga Studio API key
  • BASE_URL (optional): The base URL of your Amoga Studio instance
  • TENANT_NAME (optional): Your tenant name (can be specified per command)
  • NODE_ENV (optional): Environment mode (development/production)

Repository Information

Build & Development

Build the project:

npm run build

Development setup:

git clone https://github.com/amoga-org/mcp-server.git
cd mcp-server
npm install
npm run build

The build process compiles TypeScript to JavaScript and places the output in the build/ directory.

Support & Issues

Contributing

This project is part of the Amoga Studio ecosystem. For contributions and development guidelines, please refer to the repository documentation.

Related Servers