Duck Framework MCP

Fetch an official Duck Framework AI guide. Use this after get_ai_guides() to retrieve the full guide content for AI-assisted Duck Framework development. Always read the relevant guide before generating code instead of relying on memory.

{
  "type": "object",
  "properties": {
    "guide": {
      "type": "string"
    }
  },
  "required": [
    "guide"
  ]
}

List available Duck Framework AI guides. Use this to discover available guides before fetching one with fetch_ai_guide(). Returns guide identifiers and their descriptions.

{
  "type": "object",
  "properties": {},
  "required": []
}

Explain where Duck Framework blueprints can be located. Describes the supported blueprint layouts and when each organization approach is appropriate.

{
  "type": "object",
  "properties": {},
  "required": []
}

Return the standard internal structure of a Duck Framework blueprint. Use this before generating a new blueprint or adding files to an existing one to understand where components, pages, templates, automations, and views belong.

{
  "type": "object",
  "properties": {},
  "required": []
}

Look up a built-in Duck Framework component API. Returns the confirmed import path, container type, and supported keyword arguments for a component without requiring the full HTML components guide to be loaded. Use this before using any component that has not already been confirmed. Returns close-name suggestions when the component does not exist.

{
  "type": "object",
  "properties": {
    "component_name": {
      "type": "string"
    }
  },
  "required": [
    "component_name"
  ]
}

Return the standard Duck Framework project directory structure. Use this before creating or modifying projects to understand where files and directories belong.

{
  "type": "object",
  "properties": {},
  "required": []
}

Check Duck Framework component or page code for common mistakes. Detects known patterns such as incorrect component imports, invalid page imports, incorrect Heading usage, leading-underscore method names, and separator comments. This is a pattern check for known issues, not a complete correctness validator. An empty result only means no known issues were detected. Run this on generated component code before presenting it as final.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": [
    "code"
  ]
}

List all Duck Framework documentation categories and their pages. Use this when browsing available documentation without a specific search query.

{
  "type": "object",
  "properties": {
    "version": {
      "type": "string"
    }
  },
  "required": []
}

Analyze a Duck Framework feature request and create an implementation plan. Returns relevant documentation to read and a suggested order of operations before writing code. Use this before implementing non-trivial Duck Framework features.

{
  "type": "object",
  "properties": {
    "request": {
      "type": "string"
    },
    "version": {
      "type": "string"
    }
  },
  "required": [
    "request"
  ]
}

Rebuild the Duck Framework documentation index. Crawls the live documentation sitemap for a given version and merges the result in: curated tags/summary/category are preserved, new pages are added, and pages no longer in the sitemap are removed. Requires the admin scope.

{
  "type": "object",
  "properties": {
    "version": {
      "type": "string"
    }
  },
  "required": []
}

Scaffold a new Duck Framework blueprint. Generates a blueprint structure containing blueprint.py, views.py, and optional UI, template, and static directories following the documented Duck blueprint conventions. Returns generated file contents and the settings configuration needed to register the blueprint. This tool does not write files.

{
  "type": "object",
  "properties": {
    "blueprint_name": {
      "type": "string"
    },
    "urlpatterns": {
      "type": "string"
    },
    "enable_template_dir": {
      "type": "string"
    },
    "enable_static_dir": {
      "type": "string"
    },
    "prepend_name_to_urls": {
      "type": "string"
    }
  },
  "required": [
    "blueprint_name"
  ]
}

Scaffold a new Duck Framework project. Returns the required CLI commands and generated file contents for supported features with confirmed APIs. Unsupported features return documentation guidance instead of generated code to avoid guessing framework APIs. This tool does not write files. It only returns generated content for the calling client to add to the user's project directory.

{
  "type": "object",
  "properties": {
    "project_name": {
      "type": "string"
    },
    "features": {
      "type": "string"
    }
  },
  "required": [
    "project_name"
  ]
}

Fuzzy-search the Duck Framework documentation. Use this whenever the correct documentation page for a feature is unknown. Returns ranked matches containing title, URL, category, summary, and relevance score.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "top_k": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "version": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}