Skip to main content Skip to search

Create Your First MCP in Under 5 Minutes

Build and deploy AI-powered MCP servers that integrate seamlessly with Commands.com

Quick Start

npx create-commands-mcp my-awesome-server

✨ That's it! This single command sets up everything you need to start building your MCP server.

💡 Pro tip

Add --deploy=railway for instant Railway deployment setup

What You Get

Pre-configured Project

TypeScript setup with all dependencies and MCP SDK integration

Commands.com Integration

Built-in API gateway connection for instant deployment

Example Tools

Sample implementations to help you get started quickly

Development Server

Local testing environment with hot reload

Step-by-Step Guide

1

Create Your Server

npx create-commands-mcp my-awesome-server

This creates a new directory with your MCP server template.

Railway users: Add --deploy=railway for automatic Railway configuration

2

Navigate & Install

cd my-awesome-server && npm install

Move into your project directory and install dependencies.

3

Configure Environment

cp .env.example .env

The environment is pre-configured for Commands.com JWT authentication. No API keys needed!

Zero configuration: JWT validation works automatically with Commands.com

4

Start Development

npm run dev

Your MCP server is now running locally! Start building your tools.

5

Deploy & Import to Commands.com

1. Deploy to your preferred platform:

🚀 Railway (Recommended)

git push origin main → Deploy on railway.com
# Alternative platforms:
# Vercel, Docker, AWS, Google Cloud, etc.

2. Update mcp.yaml with your live server URL:

# mcp.yaml
upstreamUrl: "https://my-server.railway.app"

3. Import to Commands.com marketplace:

Quick Deploy to Railway (Recommended)

Deploy your MCP server to production in under 2 minutes with Railway:

1
Create with Railway config:
npx create-commands-mcp my-server --deploy=railway
2
Push to GitHub:
git init && git add . && git commit -m "Initial MCP server"
3
Deploy on Railway:

Visit railway.com → Connect GitHub repo → Auto-deploy

Result: Your MCP server is live at https://my-server-production.up.railway.app and ready for Commands.com!

Development Workflow

  1. 1.
    Create: npx create-commands-mcp my-server
  2. 2.
    Develop: Add tools in src/tools/
  3. 3.
    Test: npm run test and npm run doctor
  4. 4.
    Deploy: Use Railway, Vercel, or your preferred platform
  5. 5.
    Publish: Import to Commands.com marketplace