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
Data & State
Agent & Orchestration
Project Management
Communication
Multi-Agent & Collaboration
Planning & Project Management
Memory & Knowledge
Project & Code
Utilities
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
});