SuperMCP CLI

Connect your AI editor (Cursor, OpenCode, Claude Desktop) to powerful web tools via the Model Context Protocol (MCP).

🚀 Quick Start

Using npx (No Installation)

# Run directly with npx
npx @supermcp/cli

Global Installation

# Install globally
npm install -g @supermcp/cli

# Run
supermcp

🔧 MCP Configuration

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "supermcp": {
      "command": "npx",
      "args": ["-y", "@supermcp/cli"],
      "env": {
        "SUPERMCP_API_ENDPOINT": "https://supermcp-api.fly.dev"
      }
    }
  }
}

OpenCode

Add to ~/.config/opencode/mcp.json:

{
  "mcpServers": {
    "supermcp": {
      "command": "npx",
      "args": ["-y", "@supermcp/cli"],
      "env": {
        "SUPERMCP_API_ENDPOINT": "https://supermcp-api.fly.dev"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "supermcp": {
      "command": "npx",
      "args": ["-y", "@supermcp/cli"],
      "env": {
        "SUPERMCP_API_ENDPOINT": "https://supermcp-api.fly.dev"
      }
    }
  }
}

🛠️ Available Tools

Once configured, your AI assistant can use these tools:

web_scrape

Scrape any web page and get clean markdown content.

Example:

User: Scrape https://example.com and summarize it
AI: [Uses web_scrape tool] This page is a simple example domain...

web_search

Search the web (requires Serper API key).

Example:

User: Search for "latest React features"
AI: [Uses web_search tool] Here are the latest React features...

search_docs

Search documentation using Context7.

Example:

User: How do React hooks work?
AI: [Uses search_docs tool with library="react"]

generate_ui

Generate UI components (mock mode - no API required).

Example:

User: Create a button component
AI: [Uses generate_ui tool] Here's a button component...

📦 CLI Commands

Interactive Mode

# Login to get an API key
npx @supermcp/cli login

# Check status
npx @supermcp/cli status

# Logout
npx @supermcp/cli logout

Environment Variables

• SUPERMCP_API_ENDPOINT - API endpoint (default: https://api.supermcp.io)
• SUPERMCP_API_KEY - Your API key for authentication

🔑 Getting an API Key

1. Register at https://supermcp.io
2. Create an API key from your dashboard
3. Or use the CLI: npx @supermcp/cli login

🏗️ Self-Hosting

You can self-host the SuperMCP API:

# Clone the repository
git clone https://github.com/supermcp/supermcp.git
cd supermcp

# Deploy to Fly.io
fly deploy

# Configure CLI to use your instance
export SUPERMCP_API_ENDPOINT=https://your-app.fly.dev

📊 Rate Limits

• Free tier: 100 requests/day
• Pro tier: 10,000 requests/day
• Rate limit headers included in all responses

🐛 Troubleshooting

Tools not appearing in editor

1. Check the MCP configuration file exists and is valid JSON
2. Restart your editor after configuration changes
3. Check editor logs for MCP connection errors

API errors

# Test the API connection
curl https://supermcp-api.fly.dev/health

# Verify your API key
curl https://supermcp-api.fly.dev/api/v1/tools \
  -H "X-API-Key: your-api-key"

📄 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions welcome! See our Contributing Guide.

🌟 Support

• Documentation: https://docs.supermcp.io
• Issues: https://github.com/supermcp/supermcp/issues
• Discord: https://discord.gg/supermcp