MCP (Model Context Protocol) server for StackGen APIs. Enables AI agents (Cursor, Claude Desktop, etc.) to interact with StackGen services.

Add to your MCP config (.cursor/mcp.json or Claude Desktop config):

{
  "mcpServers": {
    "stackgen": {
      "command": "npx",
      "args": ["-y", "@appcd-dev/stackgen-mcp-server"],
      "env": {
        "STACKGEN_API_BASE_URL": "https://api.stackgen.com",
        "STACKGEN_BEARER_TOKEN": "your_token_here"
      }
    }
  }
}

Use a dedicated server for a specific API to limit exposed tools:

{
  "mcpServers": {
    "stackgen-topology": {
      "command": "npx",
      "args": [
        "-y",
        "--package=@appcd-dev/stackgen-mcp-server",
        "topology"
      ],
      "env": {
        "STACKGEN_API_BASE_URL": "https://ae.dev.stackgen.com",
        "STACKGEN_BEARER_TOKEN": "your_token_here"
      }
    },
    "stackgen-appcd": {
      "command": "npx",
      "args": [
        "-y",
        "--package=@appcd-dev/stackgen-mcp-server",
        "appcd"
      ],
      "env": {
        "STACKGEN_API_BASE_URL": "https://ae.dev.stackgen.com",
        "STACKGEN_BEARER_TOKEN": "your_token_here"
      }
    }
  }
}

Available API Servers:

• topology - Topology API tools
• appcd - Appcd API tools
• terraform-module-service - Terraform Module Service tools
• env-manager - Environment Manager tools
• exporter - Exporter tools
• vault - Vault tools
• infra-catalog-tracker - Infrastructure Catalog Tracker tools
• deployment-manager - Deployment Manager tools
• notifications - Notifications tools
• audit-manager - Audit Manager tools
• policy-generator - Policy Generator tools
• cost-estimator - Cost Estimator tools
• ai-chat - AI Chat tools

Restart your client and the tools will be available.

STACKGEN_API_BASE_URL=https://api.stackgen.com \
STACKGEN_BEARER_TOKEN=your_token \
npx -y @appcd-dev/stackgen-mcp-server --sse

Open http://localhost:3000 for the test UI, or connect to http://localhost:3000/sse.

• 314+ Auto-generated Tools from OpenAPI specs
• Dual Transport: stdio (default) for MCP clients, SSE for web
• Zero Config: Works out of the box with npx
• Modular Design: Use full server or specific API servers to control tool exposure
• Subpath Exports: Import specific servers programmatically via @appcd-dev/stackgen-mcp-server/topology, etc.

# Full server - stdio mode (default) - for MCP clients
npx -y @appcd-dev/stackgen-mcp-server

# Full server - SSE mode - for web/testing
npx -y @appcd-dev/stackgen-mcp-server --sse

# Specific API server - Topology only
npx -y --package=@appcd-dev/stackgen-mcp-server topology

# Specific API server - Appcd only
npx -y --package=@appcd-dev/stackgen-mcp-server appcd

When running in SSE mode:

# Clone and install
git clone https://github.com/appcd-dev/stackgen-api-client.git
cd stackgen-api-client/packages/stackgen-mcp-server
pnpm install

# Generate tools and build
make rebuild

# Run locally
make dev        # Development mode
make start      # Production mode

Edit spec-configs.json:

{
  "name": "NewAPI",
  "specPath": "../../api-specs/new-api.yml",
  "outputFile": "../src/tools/generated/new-api.ts",
  "pathPrefix": "/new-api",
  "allowedRoles": ["admin", "devops", "developer"]
}

Then run make rebuild. This will automatically:

• Generate tool definitions from the OpenAPI spec
• Create an entry point file (src/new-api.ts)
• Update src/tools/index.ts with helper functions
• Update package.json with exports and bin entries

The new API server will be available as:

• Bin command: npx -y --package=@appcd-dev/stackgen-mcp-server new-api
• Subpath export: @appcd-dev/stackgen-mcp-server/new-api

You can also import specific servers programmatically:

// Import specific server
import { createServer } from '@appcd-dev/stackgen-mcp-server/topology';
import { TOPOLOGY_TOOLS } from '@appcd-dev/stackgen-mcp-server/topology';

// Or import the full server
import { createServer } from '@appcd-dev/stackgen-mcp-server';

# Start server in SSE mode (full server)
npx -y @appcd-dev/stackgen-mcp-server --sse

# Or start specific API server
npx -y --package=@appcd-dev/stackgen-mcp-server topology --sse

# In another terminal
npx @modelcontextprotocol/inspector

# Connect to http://localhost:3000/sse

Private - StackGen