codeboltai/codebolt-mcp-access

Codebolt MCP Access

Execute Codebolt platform tools via the MCP interface.

Quick Start

const result = await codebolt.tools.executeTool(
  "codebolt.<namespace>",
  "<tool_name>",
  { param1: "value1", param2: "value2" }
);

Tool Categories

Core Tools

| Namespace | Use Case | |-----------|----------| | codebolt.fs | Read, write, edit files | | codebolt.git | Version control operations | | codebolt.browser | Web automation | | codebolt.terminal | Command execution | | codebolt.search | Code/file search (glob, grep, semantic) |

Data & State

| Namespace | Use Case | |-----------|----------| | codebolt.memory | Persistent data storage (JSON, markdown, episodic) | | codebolt.state | Agent and project state management | | codebolt.rag | RAG indexes and document retrieval | | codebolt.vector | Vector database operations | | codebolt.knowledge | Knowledge graph management |

Agent & Orchestration

| Namespace | Use Case | |-----------|----------| | codebolt.orchestration | Tasks, agents, threads | | codebolt.agent | Agent lifecycle management | | codebolt.task | Task CRUD operations | | codebolt.job | Work items with dependencies | | codebolt.capability | Skills and powers |

Project Management

| Namespace | Use Case | |-----------|----------| | codebolt.planning | Roadmaps and action plans | | codebolt.actionPlan | Action plan management | | codebolt.actionBlock | ActionBlock management | | codebolt.roadmap | Roadmap management | | codebolt.requirementPlan | Requirements planning | | codebolt.autoTesting | Automated testing | | codebolt.codemap | Code structure visualization | | codebolt.calendar | Events and scheduling | | codebolt.todo | Todo list management | | codebolt.review | Code review workflow | | codebolt.reviewMergeRequest | Review merge requests | | codebolt.testing | Test suite management |

Communication & Collaboration

| Namespace | Use Case | |-----------|----------| | codebolt.chat | Chat and notifications | | codebolt.message | Message handling | | codebolt.notification | Event notifications | | codebolt.collaboration | Feedback and deliberation | | codebolt.swarm | Swarm/team/role management | | codebolt.agentDeliberation | Multi-agent deliberation | | codebolt.agentPortfolio | Agent portfolio/reputation | | codebolt.groupFeedback | Group feedback sessions | | codebolt.mail | Agent mail/messaging | | codebolt.config | MCP server configuration |

Memory & Knowledge

| Namespace | Use Case | |-----------|----------| | codebolt.memory | Persistent data storage | | codebolt.episodicMemory | Episode-based memory | | codebolt.persistentMemory | Long-term memory pipelines | | codebolt.dbmemory | Database memory | | codebolt.eventLog | Event logging | | codebolt.state | Agent and project state | | codebolt.rag | RAG indexes | | codebolt.vector | Vector database | | codebolt.knowledge | Knowledge graph |

Project & Code

| Namespace | Use Case | |-----------|----------| | codebolt.project | Project info and settings | | codebolt.projectStructure | Project structure management | | codebolt.crawler | Web crawler | | codebolt.codebase | Semantic code search | | codebolt.fileIntent | File intent management |

Utilities

| Namespace | Use Case | |-----------|----------| | codebolt.code_utils | AST and pattern matching | | codebolt.tokenizer | Text tokenization | | codebolt.debug | Debugging utilities | | codebolt.kvStore | Key-value storage | | codebolt.outputParsers | Output parsing | | codebolt.sideExecution | Isolated code execution | | codebolt.userMessageManager | User message context | | codebolt.userMessageUtilities | Message utilities | | codebolt.history | Chat history summarization | | codebolt.event | Background agent events | | codebolt.hook | Event-driven hooks | | codebolt.orchestrator | Orchestrator lifecycle | | codebolt.contextRuleEngine | Conditional memory rules | | codebolt.llm | LLM inference | | codebolt.admin | Admin operations | | codebolt.mcp | MCP server management |

Reference Files

Load the reference file for detailed parameter tables:

Core

| Reference | Namespace | |-----------|-----------| | fs.md | codebolt.fs | | git.md | codebolt.git | | browser.md | codebolt.browser | | terminal.md | codebolt.terminal | | search.md | codebolt.search |

Data & State

| Reference | Namespace | |-----------|-----------| | memory.md | codebolt.memory | | state.md | codebolt.state | | rag.md | codebolt.rag | | knowledge.md | codebolt.knowledge | | context.md | codebolt.context | | codebase.md | codebolt.codebase |

Agent & Orchestration

| Reference | Namespace | |-----------|-----------| | orchestration.md | codebolt.orchestration | | agent.md | codebolt.agent | | job.md | codebolt.job | | capability.md | codebolt.capability | | admin.md | codebolt.admin | | llm.md | codebolt.llm |

Project Management

| Reference | Namespace | |-----------|-----------| | planning.md | codebolt.planning | | calendar.md | codebolt.calendar | | todo.md | codebolt.todo | | review.md | codebolt.review | | testing.md | codebolt.testing | | project.md | codebolt.project |

Communication

| Reference | Namespace | |-----------|-----------| | chat.md | codebolt.chat | | collaboration.md | codebolt.collaboration | | mcp_servers.md | codebolt.mcp |

Multi-Agent & Collaboration

| Reference | Namespace | |-----------|-----------| | swarm.md | codebolt.swarm | | agentDeliberation.md | codebolt.agentDeliberation | | agentPortfolio.md | codebolt.agentPortfolio | | groupFeedback.md | codebolt.groupFeedback | | mail.md | codebolt.mail | | collaboration.md | codebolt.collaboration |

Planning & Project Management

| Reference | Namespace | |-----------|-----------| | actionPlan.md | codebolt.actionPlan | | actionBlock.md | codebolt.actionBlock | | roadmap.md | codebolt.roadmap | | requirementPlan.md | codebolt.requirementPlan | | autoTesting.md | codebolt.autotesting | | codemap.md | codebolt.codemap | | reviewMergeRequest.md | codebolt.reviewMergeRequest |

Memory & Knowledge

| Reference | Namespace | |-----------|-----------| | episodicMemory.md | codebolt.episodicMemory | | persistentMemory.md | codebolt.persistentMemory | | dbmemory.md | codebolt.dbmemory | | eventLog.md | codebolt.eventLog |

Project & Code

| Reference | Namespace | |-----------|-----------| | projectStructure.md | codebolt.projectStructure | | crawler.md | codebolt.crawler | | hook.md | codebolt.hook | | orchestrator.md | codebolt.orchestrator | | contextRuleEngine.md | codebolt.contextRuleEngine |

Utilities

| Reference | Namespace | |-----------|-----------| | kvStore.md | codebolt.kvStore | | outputParsers.md | codebolt.outputparsers | | sideExecution.md | codebolt.sideExecution | | userMessageManager.md | codebolt.userMessageManager | | userMessageUtilities.md | codebolt.userMessageUtilities | | history.md | codebolt.history | | codeboltEvent.md | codebolt.event | | vector.md | codebolt.vector | | tokenizer.md | codebolt.tokenizer | | code_utils.md | codebolt.code_utils | | debug.md | codebolt.debug | | notification.md | codebolt.notification | | message.md | codebolt.message | | config.md | codebolt.config | | task.md | codebolt.task | | problem.md | codebolt.problem |

Common Patterns

Read then Edit

// 1. Read file first
const content = await codebolt.tools.executeTool("codebolt.fs", "read_file", {
  absolute_path: "/path/to/file.js"
});

// 2. Edit with old_string/new_string
await codebolt.tools.executeTool("codebolt.fs", "edit", {
  absolute_path: "/path/to/file.js",
  old_string: "original text",
  new_string: "replacement text"
});

Search then Act

// 1. Search for files
const files = await codebolt.tools.executeTool("codebolt.search", "glob", {
  pattern: "**/*.ts"
});

// 2. Search content
const matches = await codebolt.tools.executeTool("codebolt.search", "grep", {
  pattern: "function\\s+\\w+",
  path: "./src"
});

Multi-Agent Task

// 1. Find suitable agent
const agents = await codebolt.tools.executeTool("codebolt.orchestration", "agent_find", {
  task: "Write unit tests"
});

// 2. Create and assign task
const task = await codebolt.tools.executeTool("codebolt.orchestration", "task_create", {
  title: "Write tests for auth module"
});

// 3. Execute with agent
await codebolt.tools.executeTool("codebolt.orchestration", "task_execute", {
  task_id: task.id,
  agent_id: agents[0].id
});