AppsAI 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

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

Claude Desktop

Add to claude_desktop_config.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

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

For AI Agents (Autonomous Registration)

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

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

# 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

"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 [email protected] 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:

"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

• AppsAI Docs
• MCP Integration Guide

Support

• GitHub Issues
• Discord

License

MIT