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
});