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 invalidEXECUTION_ERROR
: Error executing the requested operationPERMISSION_DENIED
: Permission issuesTIMEOUT
: 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.