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):

*Configuration content*

Using uvx:

*Configuration content*

Replace YOUR_API_KEY with your Amoga Studio API key.

Manual Setup (For Development)

Install dependencies:

npm install

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:

*Configuration content*

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

Package Name: amogastudio
Version: 1.0.0
Repository: https://github.com/amoga-org/mcp-server
License: ISC
Keywords: MCP, Amoga Studio, Claude, Copilot, Low-code, Automation

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

Issues: GitHub Issues
Homepage: GitHub Repository

Contributing

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