Thoth MCP Tools Documentation

This document describes the available tools in the Thoth MCP Server.

Available Tools

ping

A simple connectivity test tool that verifies MCP server responsiveness.

Purpose: Verify that the MCP server is running and responding to tool calls correctly.

Parameters:

  • message (string, optional): Custom message to echo back in the response

    • Default: "ping"

    • Description: Optional message to echo back in the response

Returns: Text content with format "pong: {message}"

Examples:

  1. Basic ping without arguments:

    {
  "name": "ping",
  "arguments": {}
}

    Response: "pong: ping"

  2. Ping with custom message:

    {
  "name": "ping",
  "arguments": {
    "message": "Hello, Thoth!"
  }
}

    Response: "pong: Hello, Thoth!"

Use Cases:

  • Verify server connectivity

  • Test MCP protocol communication

  • Health check for the server

  • Debugging and troubleshooting

Error Handling:

  • No errors expected under normal operation

  • Invalid tool names will raise ValueError

Testing Tools Locally

To test the tools locally:

  1. Start the MCP server:

    python -m thoth.mcp_server.server

  2. Use an MCP client to connect and call tools via stdio

  3. Or run the unit tests:

    hatch test

Adding New Tools

To add a new tool to the server:

  1. Update the list_tools() handler in thoth/mcp_server/server.py to include your tool definition

  2. Add handling logic in the call_tool() handler

  3. Create unit tests in tests/mcp_server/test_mcp_server.py

  4. Document the tool in this file

Example tool definition structure:

Tool(
    name="your_tool_name",
    description="Description of what your tool does",
    inputSchema={
        "type": "object",
        "properties": {
            "param1": {
                "type": "string",
                "description": "Description of param1"
            }
        },
        "required": ["param1"]  # List required parameters
    }
)