com.appsai/mcp-server

Official

by appsai-inc · JavaScript

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB.

Build and deploy full-stack Next.js applications with tools for React, AWS, and MongoDB.

AppsAI MCP Server

Build and deploy full-stack apps with AI. This MCP server connects Claude Code, Cursor, Windsurf, and other AI tools to your AppsAI projects.

Supported stacks:

Frontend: Next.js with React, Tailwind CSS, and shadcn/ui
Backend: Parse Server, Express, Fastify, Hono, Supabase Edge Functions, Firebase Cloud Functions, Serverless Framework, or custom
Database: MongoDB Atlas (managed)
Infrastructure: AWS (S3, CloudFormation, EC2, Lambda, and more)

Installation

Claude Code

bash

claude mcp add appsai -e APPSAI_API_KEY=your_key -- npx -y @appsai/mcp-server

Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "appsai": {
      "command": "npx",
      "args": ["-y", "@appsai/mcp-server"],
      "env": {
        "APPSAI_API_KEY": "your_key"
      }
    }
  }
}

Cursor / Windsurf

Add to MCP settings with:

Command: npx -y @appsai/mcp-server
Environment: APPSAI_API_KEY=your_key

Getting Your API Key

For Humans

Sign up at appsai.com
Go to Settings > Billing > API Keys
Click Create API Key
Copy the key (shown once)

For AI Agents (Autonomous Registration)

AI agents can register and obtain API keys programmatically using wallet-based authentication:

python

import requests
from eth_account import Account
from eth_account.messages import encode_defunct

# Agent's wallet
private_key = "0x..."
account = Account.from_key(private_key)

BASE_URL = "https://internal.appsai.com/server/functions"
HEADERS = {"Content-Type": "application/json", "X-Parse-Application-Id": "appsai"}

# 1. Get nonce
nonce_data = requests.post(f"{BASE_URL}/getAgentAuthNonce", headers=HEADERS, json={}).json()["result"]

# 2. Sign the message
signed = account.sign_message(encode_defunct(text=nonce_data["message"]))

# 3. Register and get API key
result = requests.post(f"{BASE_URL}/registerAgentWallet", headers=HEADERS, json={
    "walletAddress": account.address,
    "signature": signed.signature.hex(),
    "nonce": nonce_data["nonce"]
}).json()["result"]

api_key = result["apiKey"]  # Use this with MCP

Adding Credits via Crypto

Agents can pay for credits using USDC on supported chains (Ethereum, Base, Arbitrum, Polygon):

python

# 1. Get payment info
info = requests.post(f"{BASE_URL}/getCryptoPaymentInfo", headers=HEADERS, json={}).json()["result"]
receiving_wallet = info["receivingWallet"]

# 2. Send USDC to receiving_wallet (via your preferred method)

# 3. Verify transaction and add credits
result = requests.post(f"{BASE_URL}/addFundsCrypto", headers=HEADERS, json={
    "walletAddress": account.address,
    "txHash": "0xYOUR_TX_HASH",
    "chainId": 8453  # Base
}).json()["result"]

print(f"Credits added: {result['creditsAdded']}")

For detailed API documentation, see Agent API Docs.

Tools (150+ Total)

Core Development Tools

Category	Tools	Description
Project	5	Create, list, and manage projects
Canvas	25	Edit React components, styles, and assets
Backend	18	Backend code, S3, CloudFormation, and AWS infrastructure
System	11	Deploy frontend/backend, connect apps, manage MCP servers
MongoDB	18	Database and collection management
Agents	9	AI prompt management and versioning

Platform Management Tools

Category	Tools	Description
Billing	15	Subscription, credits, payments, invoices
Marketplace	12	Publish, browse, and purchase templates
Seller	5	Stripe Connect, earnings, seller dashboard
Domain	7	Subdomain and custom domain management
Team	7	Collaborators, permissions, invitations
Transfer	6	Project ownership transfers
Settings	4	Project display settings and metadata
API Keys	3	Platform API key management
Cost	6	AWS costs, usage metrics, forecasts

System Tools

Tool	Description
`system_DEPLOY_BACKEND`	Deploy backend infrastructure
`system_DEPLOY_FRONTEND`	Deploy frontend to CDN
`system_DEPLOY_ALL`	Deploy both frontend and backend
`system_GET_ENVIRONMENT_STATUS`	Get deployment status and URLs
`system_GET_DEPLOY_ARTIFACTS`	Get deployment artifacts and history
`system_CONNECT_APP`	Connect two projects for cross-app operations
`system_DISCONNECT_APP`	Remove connection between projects
`system_ADD_MCP_SERVER`	Add an external MCP server to a project
`system_LIST_MCP_SERVERS`	List configured MCP servers
`system_UPDATE_MCP_SERVER`	Update MCP server configuration
`system_REMOVE_MCP_SERVER`	Remove an MCP server from project

Billing Tools

Tool	Description
`billing_GET_CURRENT_PLAN`	Get subscription plan details
`billing_CREATE_CHECKOUT`	Start subscription purchase
`billing_GET_PORTAL_SESSION`	Open Stripe billing portal
`billing_ADD_FUNDS`	Add credits to account
`billing_GET_AVAILABLE_CREDITS`	Get current credit balance
`billing_GET_INVOICES`	List invoices
`billing_GET_PAYMENT_METHODS`	List saved payment methods

Marketplace Tools

Tool	Description
`marketplace_PUBLISH_TEMPLATE`	Publish project to marketplace
`marketplace_UNPUBLISH_TEMPLATE`	Remove from marketplace
`marketplace_GET_TEMPLATES`	Browse marketplace templates
`marketplace_GET_TEMPLATE_DETAILS`	Get template info
`marketplace_FORK_TEMPLATE`	Fork a template
`marketplace_GET_MY_PUBLISHED`	User's published templates
`marketplace_GET_MY_PURCHASES`	Purchase history

Domain Tools

Tool	Description
`domain_CHECK_AVAILABILITY`	Check subdomain availability
`domain_UPDATE_SUBDOMAIN`	Update project subdomain
`domain_ADD_CUSTOM_DOMAIN`	Add custom domain
`domain_VERIFY_CUSTOM_DOMAIN`	Verify DNS configuration
`domain_REMOVE_CUSTOM_DOMAIN`	Remove custom domain

Team Tools

Tool	Description
`team_GET_COLLABORATORS`	List project collaborators
`team_INVITE_COLLABORATOR`	Invite user to project
`team_REMOVE_COLLABORATOR`	Remove collaborator
`team_UPDATE_PERMISSIONS`	Change collaborator role

Example Usage

code

"List my apps"
→ project_LIST_APPS

"Create a new Next.js app"
→ project_CREATE_APP

"Show the file tree for project abc123"
→ canvas_LIST_FILES

"Deploy the frontend"
→ system_DEPLOY_FRONTEND

"Add an MCP server to my project"
→ system_ADD_MCP_SERVER

"Check my current plan"
→ billing_GET_CURRENT_PLAN

"Publish my project to the marketplace"
→ marketplace_PUBLISH_TEMPLATE

"Add a custom domain"
→ domain_ADD_CUSTOM_DOMAIN

"Invite john@example.com to my project"
→ team_INVITE_COLLABORATOR

MCP Server Integration

AppsAI projects can connect to external MCP servers, giving your AI agents access to additional tools:

code

"Add the Stripe MCP server to my project"
→ system_ADD_MCP_SERVER with serverUrl and serverLabel

"List my configured MCP servers"
→ system_LIST_MCP_SERVERS

"Disable the Stripe MCP server"
→ system_UPDATE_MCP_SERVER with enabled: false

Once configured, AI agents in your AppsAI project can use tools from connected MCP servers.

Resources

The server provides project context as MCP resources:

appsai://projects - List of your projects
appsai://project/{id} - Project details and file structure

Prompts

Built-in prompts to build full applications:

build-youtube - Build a YouTube clone with video uploads and comments
build-slack - Build a Slack clone with real-time messaging
build-twitter - Build a Twitter/X clone with posts and follows
connect-apps - Connect two AppsAI projects together

Requirements

Node.js 18+
AppsAI account with credits
API key from Settings > Billing

Documentation

Support

License

MIT

Install

Configuration

Environment variables

APPSAI_API_KEYrequiredsecret

Your AppsAI API key from Settings → Billing → API Keys

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@appsai/mcp-server@1.0.13"
      ],
      "env": {
        "APPSAI_API_KEY": "<YOUR_APPSAI_API_KEY>"
      }
    }
  }
}