MCP Tools Reference
Detailed reference for every tool exposed by the @better-openclaw/mcp server. Each tool can be called by any MCP-compatible AI client (Claude, Cursor, Windsurf, etc.).
generate-stack
The primary tool — generates a complete, deployable Docker Compose stack from a list of service IDs. Returns all generated files as a JSON map.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectName | string | ✓ | Lowercase alphanumeric with hyphens (e.g. my-stack) |
services | string[] | ✓ | Service IDs (e.g. ["postgresql", "redis", "n8n"]) |
skillPacks | string[] | Skill pack IDs to include | |
proxy | enum | none | caddy | traefik | |
domain | string | Domain for reverse proxy routing | |
gpu | boolean | Enable GPU passthrough | |
platform | enum | linux/amd64 | linux/arm64 | windows/amd64 | macos/amd64 | macos/arm64 | |
monitoring | boolean | Include Grafana + Prometheus | |
generateSecrets | boolean | Auto-generate passwords and keys |
Returns
JSON with files (filename → content map), metadata (service count, skill count, memory estimate), and fileList.
list-services
Returns every service in the catalog. Useful for showing the user what's available or building picker UIs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
category | string | Filter by category (e.g. database, ai, monitoring) |
get-service
Get full details for a single service by its ID. Includes ports, volumes, health checks, environment variables, and dependencies.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Service ID (e.g. postgresql) |
search-services
Full-text search across service names, descriptions, tags, and categories. Returns matching services ranked by relevance.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | ✓ | Search query (e.g. vector database) |
suggest-services
Suggest services based on a natural language description. Uses keyword matching and scoring — no LLM round-trip needed. Ideal for translating user goals into concrete service lists.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
description | string | ✓ | Natural language description (e.g. AI chatbot with monitoring) |
limit | number | Max results (1–30, default 10) |
list-presets
Returns all curated presets (minimal, researcher, devops, local-ai, full) with their service lists and descriptions.
Parameters
None.
get-preset
Get full details for a specific preset including all service IDs and skill packs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Preset ID (e.g. researcher) |
list-skill-packs
Lists all available skill packs with their skill bindings and compatible services.
Parameters
None.
resolve-deps
Given a list of service IDs, resolves the full dependency graph. Shows which services get auto-added (e.g. selecting n8n auto-adds postgresql).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
services | string[] | ✓ | Service IDs to resolve |
validate-stack
Validates a proposed stack before generation. Checks for port conflicts, missing dependencies, and returns resource estimates. Use this before calling generate-stack.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
services | string[] | ✓ | Service IDs to validate |
Next Steps
- MCP Overview — setup, configuration, and examples
- Service Catalog — browse all available services