Once you’ve installed BrainGrid MCP, you can use natural language to manage requirements and tasks directly from your AI assistant.

​
Common Workflows

Create New Requirement

Save plans from Cursor or Claude Code as requirements

Build Requirement

Fetch and implement tasks for a requirement

Get Task Details

View specific task information and content

Update Task Status

Mark tasks as in progress or completed

Review Requirement

Validate implementation against acceptance criteria

Server Information

Check server status and authentication

​
Available Tools

BrainGrid MCP provides these tools to your AI assistant:

​
Requirement Management

  • create_requirement - Create new requirements from a Cursor or Claude Code plan.
  • get_requirement - View requirement details and status
  • build_requirement - Fetch a requirement and its tasks to start building them
  • review - Review the implementation against acceptance criteria of a requirement

​
Task Management

  • get_task - Get details about a specific task
  • update_task - Change task status (IN_PROGRESS, COMPLETED, etc.)

​
Information

  • info - Display server status and current context
  • auth_status - Display authentication status

​
Workflows

​
Create a new requirement / start a new feature

You can create a plan in Cursor or Claude Code and then use the create_requirement tool to save that plan as a requirement. This allows you to refine it, break it down into tasks, and then build it keeping track of your plan. 
> Create a new requirement from the plan you made

⏺ I'll create a new requirement in BrainGrid based on the plan I
  made for implementing ....

⏺ braingrid - create_requirement (MCP) (message...)
Claude Code tip #1: Use plan mode to create a plan. Claude Code tip #2: Once you have then plan you want to save, hit “ESC” and say Create a new requirement from the plan you made

​
Build a requirement

Once you have a requirement, with the tasks broken down, you can use the build_requirement tool to fetch the tasks for that requirement and start working on them. 
> Build REQ-123

⏺ I'll help you build the requirement REQ-123. Let me first fetch the requirement and its tasks.

⏺ braingrid - get_requirement (MCP) (requirementId: REQ-123)

⏺ Now let me fetch the tasks for that requirement to see what needs to be implemented.

⏺ braingrid - build_requirement (MCP) (requirementId: REQ-123)

⏺ The requirement has 5 tasks to implement...

​
Get a task

Get a task to start working on it. 
> get task 1 of REQ-123

⏺ I'll fetch task 1 from requirement REQ-123 for you.

⏺ braingrid - get_task (MCP)(requirementId: "REQ-123", taskNumber: "1", includeContent: true)

​
Update a task

If you are starting work on a task, you can use the update_task tool to update the task status to IN_PROGRESS. 
> update task 1 of REQ-123 to COMPLETED

⏺ I'll mark task 1 of REQ-661 as completed for you.

⏺ braingrid - get_task (MCP)(requirementId: "REQ-123", taskNumber:"1", includeContent: false)
  ⎿ 📋 **Task Details**

    **Task 1**: Implement Database Schema Updates for Two-Factor Aut
    … +9 lines (ctrl+r to expand)


⏺ Now I'll update the task status to COMPLETED:

⏺ braingrid - update_task (MCP)(taskId: "f987430d-4016-44e8-83bb-51454aac4a16", status: "COMPLETED")

​
Review a requirement

Once you complete a requirement, you can review it against the acceptance criteria. 
> review REQ-123

⏺ I'll review requirement REQ-123 for you.

⏺ braingrid - review (MCP)(requirementId: "REQ-123", includeDetails:true, checkTests: true)
  ⎿  # 📋 **Requirement Review Analysis**

     **Requirement ID**: 9932ae54-79fe-407b-873b-781ae5872d43
     … +1240 lines (ctrl+r to expand)

⏺ 📋 Requirement Review Analysis: [... details ...]