Tools Reference
This reference guide documents all available MCP-compatible tools in the gomcptest project, their parameters, and response formats.
Bash
Executes bash commands in a persistent shell session.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| command | string | Yes | The command to execute | 
| timeout | number | No | Timeout in milliseconds (max 600000) | 
Response
The tool returns the command output as a string.
Banned Commands
For security reasons, the following commands are banned:
alias, curl, curlie, wget, axel, aria2c, nc, telnet, lynx, w3m, links, httpie, xh, http-prompt, chrome, firefox, safari
Edit
Modifies file content by replacing specified text.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| file_path | string | Yes | Absolute path to the file to modify | 
| old_string | string | Yes | Text to replace | 
| new_string | string | Yes | Replacement text | 
Response
Confirmation message with the updated content.
GlobTool
Finds files matching glob patterns with metadata.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| pattern | string | Yes | Glob pattern to match files against | 
| path | string | No | Directory to search in (default: current directory) | 
| exclude | string | No | Glob pattern to exclude from results | 
| limit | number | No | Maximum number of results to return | 
| absolute | boolean | No | Return absolute paths instead of relative | 
Response
A list of matching files with metadata including path, size, modification time, and permissions.
GrepTool
Searches file contents using regular expressions.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| pattern | string | Yes | Regular expression pattern to search for | 
| path | string | No | Directory to search in (default: current directory) | 
| include | string | No | File pattern to include in the search | 
Response
A list of matches with file paths, line numbers, and matched content.
LS
Lists files and directories in a given path.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| path | string | Yes | Absolute path to the directory to list | 
| ignore | array | No | List of glob patterns to ignore | 
Response
A list of files and directories with metadata.
Replace
Completely replaces a file’s contents.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| file_path | string | Yes | Absolute path to the file to write | 
| content | string | Yes | Content to write to the file | 
Response
Confirmation message with the content written.
View
Reads file contents with optional line range.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| file_path | string | Yes | Absolute path to the file to read | 
| offset | number | No | Line number to start reading from | 
| limit | number | No | Number of lines to read | 
Response
The file content with line numbers in cat -n format.
dispatch_agent
Launches a new agent with access to specific tools.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| prompt | string | Yes | The task for the agent to perform | 
Response
The result of the agent’s task execution.
imagen
Generates and manipulates images using Google’s Imagen API.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| prompt | string | Yes | Description of the image to generate | 
| aspectRatio | string | No | Aspect ratio for the image (default: “1:1”) | 
| safetyFilterLevel | string | No | Safety filter level (default: “block_some”) | 
| personGeneration | string | No | Person generation policy (default: “dont_allow”) | 
Response
Returns a JSON object with the generated image path and metadata.
duckdbserver
Provides data processing capabilities using DuckDB.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| query | string | Yes | SQL query to execute | 
| database | string | No | Database file path (default: in-memory) | 
Response
Query results in JSON format.
imagen_edit
Edits images using Google’s Gemini 2.0 Flash model with natural language instructions.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| base64_image | string | Yes | Base64 encoded image data (without data:image/… prefix) | 
| mime_type | string | Yes | MIME type of the image (e.g., “image/jpeg”, “image/png”) | 
| edit_instruction | string | Yes | Text describing the edit to perform | 
| temperature | number | No | Randomness in generation (0.0-2.0, default: 1.0) | 
| top_p | number | No | Nucleus sampling parameter (0.0-1.0, default: 0.95) | 
Response
Returns edited image information including file path and HTTP URL.
plantuml
Generates PlantUML diagram URLs from plain text diagrams with syntax validation and error correction.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| plantuml_code | string | Yes | PlantUML diagram code in plain text format | 
| output_format | string | No | Output format: “svg” (default) or “png” | 
Response
Returns URL pointing to PlantUML server for SVG/PNG rendering.
plantuml_check
Validates PlantUML file syntax using the official PlantUML processor.
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| file_path | string | Yes | Path to PlantUML file (.puml, .plantuml, .pu) | 
Response
Returns validation result with detailed error messages if syntax issues are found.
sleep
Pauses execution for a specified number of seconds (useful for testing and demonstrations).
Parameters
| Parameter | Type | Required | Description | 
|---|---|---|---|
| seconds | number | Yes | Number of seconds to sleep | 
Response
Confirmation message after sleep completion.
Tool Response Format
Most tools return JSON responses with the following structure:
{
  "result": "...", // String result or
  "results": [...], // Array of results
  "error": "..." // Error message if applicable
}
Error Handling
All tools follow a consistent error reporting format:
{
  "error": "Error message",
  "code": "ERROR_CODE"
}
Common error codes include:
- INVALID_PARAMS: Parameters are missing or invalid
- EXECUTION_ERROR: Error executing the requested operation
- PERMISSION_DENIED: Permission issues
- TIMEOUT: Operation timed out
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.