ShortcutSistem + Band MCP Server

Combined MCP server for Cursor Cloud — gives you Band platform control + ShortcutSistem tools in one HTTP connection.

Cursor Cloud ──MCP (HTTP)──→ This Server ──REST──→ Band AI
                                            └──→ ShortcutSistem Tools (built-in)

Requirements

• Python 3.11+ (band-sdk requires 3.11)

• Band API key from https://app.band.ai/settings/api-keys

Related MCP server: blogburst-mcp-server

Tools Available

Band Platform Tools (5)

ShortcutSistem Tools (7)

Setup

1. Get Your Band API Key

https://app.band.ai/settings/api-keys

2. Deploy to Railway (Recommended)

1. Push to GitHub:

   cd shortcutsistem-band-mcp
   git init && git add . && git commit -m "Initial commit"
   # Create repo on GitHub: https://github.com/new
   git remote add origin https://github.com/Therealratoshen/shortcutsistem-band-mcp.git
   git push -u origin main

2. Deploy on Railway:

   • Go to railway.app → New Project → Deploy from GitHub

   • Connect the shortcutsistem-band-mcp repo

   • Add environment variable: BAND_API_KEY = band_a_1781922604_x9vo02skdxefhp8JqL3jzesZKGDb5v1b

   • Railway auto-detects Python from pyproject.toml

   • Wait 2-3 minutes → copy the URL (e.g. https://shortcutsistem-band-mcp.up.railway.app)

3. Test the endpoint:

   https://shortcutsistem-band-mcp.up.railway.app/mcp/

   You should see an MCP welcome message.

3. Connect to Cursor Cloud

Add to Cursor Cloud MCP settings (~/.cursor/mcp_settings.json):

{
  "mcpServers": {
    "shortcutsistem-band": {
      "url": "https://shortcutsistem-band-mcp.up.railway.app/mcp/"
    }
  }
}

Restart Cursor. The tools will appear in the agent panel.

4. Local Development

cd shortcutsistem-band-mcp
cp .env.example .env
# Edit .env and add your BAND_API_KEY
uv sync
uv run python server.py
# Server runs on http://localhost:8000/mcp/

Transport

Uses streamable-http (FastMCP) — compatible with Cursor Cloud MCP HTTP transport.

Not stdio. Not SSE. HTTP with POST + streaming responses.

Troubleshooting

"Module not found: band"

• Make sure band-client-rest is installed: uv sync or pip install band-client-rest band-sdk

"BAND_API_KEY environment variable is required"

• Set the BAND_API_KEY environment variable in Railway dashboard

Server starts but tools don't appear in Cursor

• Check Cursor Cloud MCP settings use /mcp/ suffix on the URL

• Verify the URL is accessible from the internet (Cursor Cloud runs in browser)

Python version error

• Ensure Railway uses Python 3.11+ (check in Railway dashboard → Runtime)