@appsai/mcp-server 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AppsAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,27 @@
 # AppsAI MCP Server
 
-The official Model Context Protocol (MCP) server for AppsAI. Connect Claude Code and other MCP-compatible tools to your AppsAI projects.
+[![npm version](https://img.shields.io/npm/v/@appsai/mcp-server.svg)](https://www.npmjs.com/package/@appsai/mcp-server)
+[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/com.appsai/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<p align="center">
+  <img src="logo.png" alt="AppsAI Logo" width="128" height="128">
+</p>
+
+Build and deploy full-stack Next.js applications through natural language. Connect Claude Code and other MCP-compatible tools to your AppsAI projects.
 
 ## Quick Start
 
 ### 1. Get an API Key
 
-1. Sign in to [AppsAI](https://appsai.com)
-2. Go to **Settings → Billing** and scroll to **API Keys**
+1. Sign up at [appsai.com](https://appsai.com)
+2. Go to **Settings → Billing → API Keys**
 3. Click **Create Key** and copy it (shown only once)
 
 ### 2. Add to Claude Code
 
 ```bash
-claude mcp add appsai --env APPSAI_API_KEY=appsai_xxxxx -- npx @appsai/mcp-server
+claude mcp add appsai --env APPSAI_API_KEY=your_key_here -- npx @appsai/mcp-server
 ```
 
 ### 3. Start Building
@@ -21,53 +29,95 @@ claude mcp add appsai --env APPSAI_API_KEY=appsai_xxxxx -- npx @appsai/mcp-serve
 ```
 "List my projects"
 "Create a new project using the nextjs-starter template"
-"Show the files in project abc123"
-"Add a button component to app/page.tsx"
+"Show the element tree for app/page.tsx in project abc123"
+"Add a hero section with a gradient background"
 "Deploy the frontend"
 ```
 
 ## Features
 
-- **87 Tools** across 8 categories
-- **Project Management** — Create, list, delete projects
-- **Frontend Development** — Edit React/Next.js components, styles, dependencies
-- **Backend Development** — Manage Parse Server cloud functions
-- **Deployment** — Deploy to AWS with one command
-- **AWS Infrastructure** — Run any AWS CLI command, manage CloudFormation
-- **MongoDB Atlas** — Database and cluster management
-- **Pay-as-you-go** — Uses your AppsAI credit balance
+- **98 Tools** across 8 categories for full-stack development
+- **One-command deployment** to AWS CloudFront + Lambda
+- **React/Next.js** frontend development with visual component editing
+- **Parse Server** backend with cloud functions
+- **AWS Infrastructure** via CloudFormation
+- **MongoDB Atlas** database management
+- **Pay-as-you-go** billing using your AppsAI credit balance
 
 ## Tool Categories
 
 | Category | Tools | Description |
 |----------|-------|-------------|
-| Project | 5 | Create, list, manage projects |
-| Canvas | 25 | Frontend React/Next.js development |
-| Server | 6 | Backend Parse Server development |
-| System | 5 | Deployment & environment |
-| AWS | 12 | Infrastructure via CLI + CloudFormation |
-| MongoDB | 18 | Database operations |
-| Agent | 9 | AI prompt management |
-| Shared | 7 | Cross-category communication |
+| **Project** | 5 | Create, list, delete, get project details |
+| **Canvas** | 25 | Frontend React/Next.js development |
+| **Server** | 6 | Backend Parse Server cloud functions |
+| **System** | 5 | Deployment & environment management |
+| **AWS** | 23 | CloudFormation, S3, Lambda, CloudWatch |
+| **MongoDB** | 18 | Clusters, databases, collections, queries |
+| **Agent** | 9 | AI prompt management |
+| **Shared** | 7 | Cross-category communication |
 
-## Billing
+## Example Workflows
 
-Usage is charged to your AppsAI credit balance:
-- **File operations** — Free
-- **AI generation** — Model-based pricing
-- **AWS operations** — Based on resources
-- **MongoDB** — Based on cluster tier
-- **Deployment** — Per deployment
+### Create and Deploy a New App
+
+```
+1. "What templates are available?"
+2. "Create a new project using the nextjs-starter template"
+3. "Add a landing page with a hero section and feature grid"
+4. "Deploy the frontend"
+```
+
+### Modify an Existing Project
+
+```
+1. "List my projects"
+2. "Show the files in project happy-purple-fox"
+3. "Update the navbar to include a login button"
+4. "Deploy all"
+```
+
+### Database Operations
+
+```
+1. "Create a MongoDB collection called 'users' in project abc123"
+2. "Add an index on the email field"
+3. "Query all users created in the last 7 days"
+```
 
 ## Environment Variables
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `APPSAI_API_KEY` | Yes | Your API key from Settings → Billing |
+| `APPSAI_API_KEY` | Yes | Your API key from Settings → Billing → API Keys |
+
+## Billing
+
+Usage is charged to your AppsAI credit balance:
+
+| Operation | Cost |
+|-----------|------|
+| File read/write | Free |
+| AI generation | Model-based pricing |
+| AWS operations | Based on resources |
+| MongoDB | Based on cluster tier |
+| Deployment | Per deployment |
+
+View usage at [appsai.com/editor/settings](https://appsai.com/editor/settings) → Billing → Credit History.
 
 ## Documentation
 
-Full documentation: [appsai.com/docs/mcp](https://appsai.com/docs/mcp)
+- [Quick Start Guide](https://appsai.com/docs/mcp/quickstart)
+- [Authentication](https://appsai.com/docs/mcp/authentication)
+- [Tools Reference](https://appsai.com/docs/mcp/tools)
+- [Billing & Usage](https://appsai.com/docs/mcp/billing)
+
+## Links
+
+- [Website](https://appsai.com)
+- [Documentation](https://appsai.com/docs/mcp)
+- [npm Package](https://www.npmjs.com/package/@appsai/mcp-server)
+- [MCP Registry](https://registry.modelcontextprotocol.io/servers/com.appsai/mcp-server)
 
 ## License
 

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@appsai/mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Official MCP server for AppsAI - connect Claude Code to your AppsAI projects",
+  "mcpName": "com.appsai/mcp-server",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -28,7 +29,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "server.json",
+    "logo.png"
   ],
   "keywords": [
     "mcp",

package/server.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.appsai/mcp-server",
+  "description": "Build and deploy full-stack Next.js applications through natural language. 98 tools for frontend development, backend APIs, AWS infrastructure, MongoDB, and one-command deployment.",
+  "repository": {
+    "url": "https://github.com/appsai/mcp-server",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@appsai/mcp-server",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "APPSAI_API_KEY",
+          "description": "Your AppsAI API key from Settings → Billing → API Keys",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ],
+  "tools": [
+    {
+      "name": "project_LIST_PROJECTS",
+      "description": "List all projects owned by or shared with the user"
+    },
+    {
+      "name": "project_CREATE_PROJECT",
+      "description": "Create a new project from a starter template"
+    },
+    {
+      "name": "project_GET_TEMPLATES",
+      "description": "Get available starter templates"
+    },
+    {
+      "name": "canvas_SET_ELEMENT",
+      "description": "Create or modify React components"
+    },
+    {
+      "name": "canvas_GET_ELEMENT_TREE",
+      "description": "Get the component tree for a file"
+    },
+    {
+      "name": "system_DEPLOY_FRONTEND",
+      "description": "Deploy frontend to CloudFront CDN"
+    },
+    {
+      "name": "system_DEPLOY_BACKEND",
+      "description": "Deploy backend to AWS"
+    },
+    {
+      "name": "system_DEPLOY_ALL",
+      "description": "Deploy frontend and backend together"
+    }
+  ],
+  "categories": [
+    "developer-tools",
+    "deployment",
+    "cloud",
+    "database"
+  ],
+  "highlights": [
+    "98 tools across 8 categories",
+    "One-command deployment to AWS",
+    "Full-stack Next.js + Parse Server",
+    "MongoDB Atlas integration",
+    "Pay-as-you-go billing"
+  ]
+}