home / mcp / appsai mcp server

AppsAI MCP Server

Provides a bridge to external MCP servers, enabling AppsAI projects to access additional tools via standard MCP connections and environment key management.

Installation
Add the following to your MCP client configuration file.

Configuration

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

You can connect AppsAI projects to external MCP servers to extend tool access, automate workflows, and manage AI-assisted development across frontend, backend, and infrastructure components. This MCP server enables you to run the AppsAI MCP client locally via npm-based execution, securely pass API keys, and register AI agents to access additional capabilities from connected servers.

How to use

You use the AppsAI MCP server by wiring it into your AppsAI projects as an external MCP server. Start by adding the MCP server to your project, then configure your client to communicate with it. Once connected, your AI agents can invoke tools exposed by the MCP server to perform actions such as project management, code generation, deployment, and resource orchestration within your AppsAI environment.

How to install

Prerequisites you need before installation include Node.js 18 or later and an AppsAI account with credits.

Install steps proceed as follows. Run the commands in order to set up the MCP server for AppsAI projects.

# 1) Ensure Node.js is installed (version 18+). Check with:
node -v

# 2) Install the MCP server globally or run from project context as needed (examples show local usage):
# Claude Code path
claude mcp add appsai -e APPSAI_API_KEY=your_key -- npx -y @appsai/mcp-server

# Claude Desktop configuration (example JSON snippet you can adapt)
# Add to claude_desktop_config.json
{
  "mcpServers": {
    "appsai": {
      "command": "npx",
      "args": ["-y", "@appsai/mcp-server"],
      "env": {
        "APPSAI_API_KEY": "your_key"
      }
    }
  }
}

# Cursor / Windsurf configuration (MCP settings):
# Command: npx -y @appsai/mcp-server
# Environment: APPSAI_API_KEY=your_key

# 3) Install and run locally if you prefer a direct npm-based approach
# This step demonstrates running the MCP server via npx in the project context
npx -y @appsai/mcp-server

# 4) Ensure your API key is set correctly in the environment or as part of the command line
export APPSAI_API_KEY=your_key

# 5) Start or register the server per your project setup as needed by your AppsAI workflow

Additional sections

Security and credentials: store API keys securely and prefer environment variables over hard-coding keys in commands or configuration files. Use project-scoped or user-scoped credentials as appropriate for your workflow.

Usage notes: you can register multiple MCP servers to a single AppsAI project. Each server may provide a different set of tools or capabilities. You can enable or disable individual MCP servers as your needs evolve.

Troubleshooting tips: ensure that the APPSAI_API_KEY is correctly provided to each MCP client invocation. If your AI agents report missing tools or failed invocations, verify the MCP server is reachable and that the correct server name or label is used in your AppsAI project settings.

Resources

The AppsAI MCP integration supports connecting to external MCP servers to extend tool availability for your projects. Use the provided commands to add and configure MCP servers within your AppsAI workflow.

Available tools

system_DEPLOY_BACKEND

Deploy backend infrastructure for the MCP ecosystem, including services, databases, and supporting resources.

system_DEPLOY_FRONTEND

Deploy frontend assets to a CDN or hosting environment, ensuring the user interface is accessible.

system_DEPLOY_ALL

Deploy both frontend and backend components of the AppsAI project and MCP integration.

system_GET_ENVIRONMENT_STATUS

Retrieve deployment status, URLs, and health checks for all connected MCP components.

system_GET_DEPLOY_ARTIFACTS

Obtain deployment artifacts and historical records related to MCP server deployments.

system_CONNECT_APP

Connect two AppsAI projects to enable cross-app operations and shared tools.

system_DISCONNECT_APP

Disconnect two AppsAI projects and remove cross-project tool access.

system_ADD_MCP_SERVER

Add an external MCP server to a project for extended tooling.

system_LIST_MCP_SERVERS

List all MCP servers configured for a given AppsAI project.

system_UPDATE_MCP_SERVER

Update the configuration of an existing MCP server in the project.

system_REMOVE_MCP_SERVER

Remove an MCP server from the project configuration.

billing_GET_CURRENT_PLAN

Retrieve your current subscription plan and included credits.

billing_CREATE_CHECKOUT

Initiate a subscription purchase flow for the user.

billing_GET_PORTAL_SESSION

Open the Stripe billing portal for managing payments and plans.

billing_ADD_FUNDS

Add credits or funds to your AppsAI account.

billing_GET_AVAILABLE_CREDITS

Query the current credit balance across your account.

billing_GET_INVOICES

List invoices associated with the account and subscriptions.

billing_GET_PAYMENT_METHODS

List saved payment methods for future charges.

marketplace_PUBLISH_TEMPLATE

Publish a project template to the marketplace for sharing or sale.

marketplace_UNPUBLISH_TEMPLATE

Remove a published template from the marketplace.

marketplace_GET_TEMPLATES

Browse available templates in the marketplace.

marketplace_GET_TEMPLATE_DETAILS

Get detailed information about a marketplace template.

marketplace_FORK_TEMPLATE

Fork a marketplace template into your own workspace.

marketplace_GET_MY_PUBLISHED

List templates you have published on the marketplace.

marketplace_GET_MY_PURCHASES

View templates you have purchased from the marketplace.

domain_CHECK_AVAILABILITY

Check if a subdomain is available for a project.

domain_UPDATE_SUBDOMAIN

Update the subdomain associated with a project.

domain_ADD_CUSTOM_DOMAIN

Add a custom domain to your project.

domain_VERIFY_CUSTOM_DOMAIN

Verify DNS configuration for a custom domain.

domain_REMOVE_CUSTOM_DOMAIN

Remove a custom domain from the project.

team_GET_COLLABORATORS

List collaborators for the current project.

team_INVITE_COLLABORATOR

Invite a new user to join the project with specified permissions.

team_REMOVE_COLLABORATOR

Remove a collaborator from the project.

team_UPDATE_PERMISSIONS

Change a collaborator's role or permissions within the project.