create_block
Add new content blocks to document sections including paragraphs, code snippets, lists, and tables to organize and structure your documents effectively.
Instructions
Create new block in specified section.
**TIP: Block IDs are auto-generated, but you can identify blocks later by their content.
Consider adding meaningful content/titles to make blocks easier to find with get_outline().**
Args:
project_id: Project identifier
section_id: Section ID to add block to
block_type: Block type - paragraph/code/list/table
content: Content for paragraph/code blocks
items: Items for list blocks
language: Language for code blocks
header: Header row for table blocks
rows: Data rows for table blocks
feature_id: Feature identifier (for RBT documents)
doc_type: Document type - REQ/BP/TASK (for RBT documents)
file_path: File path relative to docs/ (for general documents)
Returns:
New block ID
Example:
# Create paragraph
create_block(
project_id="knowledge-smith",
file_path="docs/guide.md",
section_id="sec-intro",
block_type="paragraph",
content="This is a new paragraph."
)
# Create list
create_block(
project_id="knowledge-smith",
file_path="docs/guide.md",
section_id="sec-features",
block_type="list",
items=["Feature 1", "Feature 2"]
)
@REQ: REQ-rbt-mcp-tool
@BP: BP-rbt-mcp-tool
@TASK: TASK-009-CreateBlockTool
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_type | Yes | ||
| content | No | ||
| doc_type | No | ||
| feature_id | No | ||
| file_path | No | ||
| header | No | ||
| items | No | ||
| language | No | ||
| project_id | Yes | ||
| rows | No | ||
| section_id | Yes |