The @microservices-sh/mcp server provides AI agents with a typed planning layer for discovering, composing, validating, generating, and deploying Cloudflare-native apps using reusable microservices.sh modules.

Template & Module Discovery

• list_templates / inspect_template – Browse and deep-dive into available app templates (e.g., booking-sveltekit)

• list_modules / inspect_module – Discover and inspect verified building-block modules (auth, booking, payment, etc.) including their contracts, permissions, hooks, events, and storage needs

Documentation

• list_module_docs / get_module_doc – List and retrieve LLM-readable documentation pages with implementation guidance, rules, and agent notes

Local Planning & Validation (read-only, no file writes)

• compose_app – Compose a template + modules into a checked app contract and lockfile plan

• validate_config – Validate template, module list, and configuration before generation

• generate_project – Generate project source files in memory for agent inspection without touching the filesystem

• run_checks – Run local contract and readiness checks to verify module compatibility and operational guardrails

• get_secrets_status – Report required secret names and configured/missing status without exposing values

• create_preview_plan – Build a local preview-deployment readiness plan (resources, checks, warnings, approval steps) without mutating remote state

Module Lifecycle Management

• plan_add_module – Plan an approval-gated module addition, reporting lockfile changes and review gates

• check_updates – Compare locked module versions against the registry to identify available updates

• plan_module_upgrade – Plan a version upgrade and report approval gates, compatibility notes, and lockfile impact

Remote Deployment (mutating, requires API key)

• deploy_preview – Trigger a remote preview deployment via the microservices.sh control plane (requires confirm: "preview" and prior plan review)

• get_deployment_status – Poll a remote preview deployment's status, errors, and metadata

Allows to build and deploy Cloudflare-native applications with verified modules, local checks, and approval-gated deploy plans.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@microservices-sh/mcp list available templates for a new project"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.