MCP Quick Start

Create and deploy your first MCP server in under 5 minutes

What You'll Build

A working MCP server with JWT authentication
Basic tools (ping, echo, datetime)
Live deployment ready for Commands.com

Create Your MCP Server

Use our scaffolding tool to generate a complete MCP server with TypeScript, tests, and deployment configs.

# Interactive mode - prompts for options
npx create-commands-mcp

# Direct mode - specify everything upfront
npx create-commands-mcp my-server --template=basic --deploy=railway

Choose Your Template

Basic: ping, echo, datetime tools
API: external API integrations (weather, cat facts)
Data: file processing (JSON, CSV parsing)

Test Locally

cd my-server
npm install
npm run dev

Your server starts at http://localhost:3000

# Test the health endpoint
curl http://localhost:3000/health

# Test a tool (without JWT for local development)
curl -X POST http://localhost:3000/tools/ping \
 -H "Content-Type: application/json" \
 -d '{"message": "Hello World"}'

Deploy to Railway

Railway provides the fastest way to get your MCP server live with zero configuration.

# Push to GitHub
git init && git add . && git commit -m "Initial MCP server"
git remote add origin https://github.com/yourusername/my-server.git
git push -u origin main

Visit railway.app

Railway auto-detects and deploys

No configuration needed - the railway.json handles everything

Get your live URL

Example: https://my-server-production.up.railway.app