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
| 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 |
Input Schema (JSON Schema)
{
"properties": {
"block_type": {
"title": "Block Type",
"type": "string"
},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"doc_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doc Type"
},
"feature_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Feature Id"
},
"file_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "File Path"
},
"header": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Header"
},
"items": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Items"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Language"
},
"project_id": {
"title": "Project Id",
"type": "string"
},
"rows": {
"anyOf": [
{
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Rows"
},
"section_id": {
"title": "Section Id",
"type": "string"
}
},
"required": [
"project_id",
"section_id",
"block_type"
],
"type": "object"
}