Skip to main content

​
Overview

Suga provides seamless integration with AI coding agents through the Model Context Protocol (MCP). The Suga CLI MCP server gives AI assistants direct access to:
  • Your Suga Infrastructure: Platforms, templates, plugins, and build APIs
  • Complete Documentation: All Suga guides, CLI references, and how-tos
  • Unified Experience: Single server for both infrastructure and documentation
This integration allows AI tools to help you develop Suga applications with accurate, up-to-date information and direct access to your team’s infrastructure resources.

​
Suga CLI MCP Server

The embedded MCP server in the Suga CLI provides comprehensive access to both your infrastructure and documentation.

​
What You Get

Infrastructure APIs:
  • List and query your team’s platforms, templates, and plugin libraries
  • Access platform specifications and build manifests
  • Generate Terraform from suga.yaml files
  • Browse available plugins and their configurations
Documentation:
  • Search all Suga documentation in real-time
  • Access CLI references and guides
  • Get help with application and platform development
  • Query plugin development documentation
Authentication: Uses your existing suga login credentials

​
Installation

  • Claude Code
  • Cursor
  • Windsurf
PrerequisitesFirst, ensure you’re logged in to Suga:
suga login
Add the MCP ServerAdd the Suga CLI MCP server using the stdio transport:
claude mcp add suga suga mcp
This configures Claude Code to run suga mcp as an MCP server, giving it access to both your infrastructure and documentation.Verify InstallationCheck that the server was added successfully:
claude mcp list
You should see suga in the list of available MCP servers.UsageOnce configured, Claude Code can:
  • Query Suga documentation when you ask questions
  • Help you build suga.yaml application files
  • Access your team’s platforms and templates
  • Assist with platform and plugin development
Example queries:
  • “What platforms are available for my team?”
  • “Help me create a suga.yaml for a web service with a PostgreSQL database”
  • “Show me the build manifest for the aws-lambda platform”
  • “How do I create a custom plugin?”
Project-Specific ConfigurationTo share this configuration with your team, add it to your project’s .mcp.json file:
{
  "mcpServers": {
    "suga": {
      "command": "suga",
      "args": ["mcp"]
    }
  }
}
Commit this file to your repository so all team members can use the Suga MCP server.Documentation: Claude Code MCP Guide

​
Features

The Suga MCP server provides:

​
Infrastructure Tools

  • list_platforms - List all platforms available to your team
  • get_platform - Get detailed platform specifications
  • get_build_manifest - Get complete build manifests with plugin details
  • list_templates - List available application templates
  • get_template - Get specific template details
  • list_plugin_libraries - Browse available plugin libraries
  • get_plugin_manifest - Access plugin manifests and schemas
  • build - Generate Terraform from suga.yaml files

​
Documentation Resources

  • Application Schema - JSON schema for suga.yaml validation
  • Development Guides - Complete guides for application, platform, and plugin development
  • Real-time Docs - Always up-to-date Suga documentation

​
Learn More