Overview

MCP (Model Context Protocol) is a standard protocol that allows AI tools (like Cursor, Claude Code, Windsurf) to interact with AgileBuilder.

Through MCP, AI can:

Browse available templates
Get template details
Generate projects

MCP ensures AI uses the same template system as humans, guaranteeing AI-generated code follows team conventions.

MCP Tools

AgileBuilder provides the following MCP tools:

listTemplates

List all available templates.

Returns:

{
  "templates": [
    {
      "name": "react-starter",
      "description": "React project starter template"
    },
    {
      "name": "vue-admin",
      "description": "Vue admin dashboard template"
    }
  ]
}

getTemplateInfo

Get detailed template information and variable definitions.

Parameters:

{
  "template": "react-starter"
}

Returns:

{
  "name": "react-starter",
  "description": "React project starter template",
  "variables": [
    {
      "name": "projectName",
      "type": "string",
      "required": true
    },
    {
      "name": "useTypeScript",
      "type": "boolean",
      "default": true
    }
  ]
}

generateProject

Generate a project from a template.

Parameters:

{
  "template": "react-starter",
  "output": "./my-app",
  "variables": {
    "projectName": "my-app",
    "useTypeScript": true
  }
}

Returns:

{
  "success": true,
  "projectPath": "./my-app",
  "message": "Project generated successfully"
}

Configure MCP Service

Start the MCP Service

agilebuilder mcp start

Listens on http://localhost:3457 by default.

Configure AI Tools

Cursor

Add the MCP service in Cursor settings:

{
  "mcp": {
    "servers": {
      "agilebuilder": {
        "url": "http://localhost:3457"
      }
    }
  }
}

Claude Code

Add to Claude Code configuration:

claude code --mcp agilebuilder http://localhost:3457

Windsurf

Configure the MCP server address in Windsurf settings.

AI Usage Examples

Once configured, you can use it in AI conversations like this:

"Create a project called my-app using the react-starter template with TypeScript enabled"

AI will automatically call:

listTemplates - Browse available templates
getTemplateInfo - Get template variables
generateProject - Generate the project

Supported AI Tools

Tool	Support Status	Notes
Cursor	Fully supported	Complete MCP configuration
Claude Code	Fully supported	Complete MCP configuration
Windsurf	Fully supported	Complete MCP configuration
GitHub Copilot	Coming soon	Waiting for official support

Document Resources

MCP can also access documents you've ingested in AgileBuilder:

resource://agile-builder/docs/coding-standards
resource://agile-builder/docs/api-spec

AI can query these documents in real time to ensure generated content follows team conventions.

Next Steps

MCP Protocol Introduction - More detailed MCP protocol documentation
MCP Service Configuration - Configure MCP service
AI Workflow - Configure AI to work according to team standards