MCP Server

🚀 AppsAI MCP Server

Build and deploy full-stack apps with AI. This MCP server integrates Claude Code, Cursor, Windsurf, and other AI tools into 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)

🚀 Quick Start

📦 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.

✨ Features

🛠️ Core Development Tools

📊 Platform Management Tools

🖥️ System Tools

💰 Billing Tools

🛒 Marketplace Tools

🌐 Domain Tools

👥 Team Tools

💻 Usage Examples

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

"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