tables_db_get_transaction

Retrieve a specific database transaction by its unique ID to track changes, verify operations, or audit data modifications within Appwrite projects.

Instructions

Get a transaction by its unique ID.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`transaction_id`	Yes	Transaction ID.

Implementation Reference

src/mcp_server_appwrite/server.py:102-122 (handler)

Generic MCP tool execution handler. Retrieves the tool's bound method from the registry (populated by TablesDB service) and invokes it with the provided arguments. This executes tables_db_get_transaction by calling TablesDB.get_transaction.**

@server.call_tool()
async def handle_call_tool(
    name: str, arguments: dict | None
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
    
    try:
        tool_info = tools_manager.get_tool(name)
        if not tool_info:
            raise McpError(f"Tool {name} not found")
        
        bound_method = tool_info["function"]
        result = bound_method(**(arguments or {}))
        if hasattr(result, 'to_dict'):
            result_dict = result.to_dict()
            return [types.TextContent(type="text", text=str(result_dict))]
        return [types.TextContent(type="text", text=str(result))]
    except AppwriteException as e:
        return [types.TextContent(type="text", text=f"Appwrite Error: {str(e)}")]
    except Exception as e:
        return [types.TextContent(type="text", text=f"Error: {str(e)}")]

src/mcp_server_appwrite/server.py:70-71 (registration)
Registers the TablesDB Appwrite service wrapper, which exposes TablesDB methods as MCP tools prefixed with 'tables_db_', including 'tables_db_get_transaction'.
```
if args.tables_db:
    tools_manager.register_service(Service(TablesDB(client), "tables_db"))
```

src/mcp_server_appwrite/service.py:73-127 (schema)

Dynamically inspects TablesDB instance methods (including get_transaction), constructs tool names like 'tables_db_get_transaction', generates JSON schema from type hints/docstrings, and registers the tool definition and bound function.

def list_tools(self) -> Dict[str, Dict]:
    """Lists all available tools for this service"""
    tools = {}

    for name, func in inspect.getmembers(self.service, predicate=inspect.ismethod):
        if name.startswith('_'): # Skip private methods
            continue

        original_func = func.__func__
        
        # Skip if not from the service's module
        if original_func.__module__ != self.service.__class__.__module__:
            continue

        # Get the overridden name if it exists
        tool_name = self._method_name_overrides.get(name, f"{self.service_name}_{name}")

        docstring = parse(original_func.__doc__)
        signature = inspect.signature(original_func)
        type_hints = get_type_hints(original_func)

        properties = {}
        required = []

        for param_name, param in signature.parameters.items():
            if param_name == 'self':
                continue

            param_type = type_hints.get(param_name, str)
            properties[param_name] = self.python_type_to_json_schema(param_type)
            properties[param_name]["description"] = f"Parameter '{param_name}'"
            
            for doc_param in docstring.params:
                if doc_param.arg_name == param_name:
                    properties[param_name]["description"] = doc_param.description

            if param.default is param.empty:
                required.append(param_name)

        tool_definition = Tool(
            name=tool_name,
            description=f"{docstring.short_description or "No description available"}",
            inputSchema={
                "type": "object",
                "properties": properties,
                "required": required
            }
        )
        
        tools[tool_name] = {
            "definition": tool_definition,
            "function": func
        }
        
    return tools

src/mcp_server_appwrite/tool_manager.py:10-14 (registration)
ToolManager.register_service: Appends the service and merges its tools (like tables_db_get_transaction) into the global tools_registry used by list_tools() and call_tool().
```
def register_service(self, service: Service):
    """Register a new service and its tools"""
    self.services.append(service)
    self.tools_registry.update(service.list_tools())
```

src/mcp_server_appwrite/server.py:92-94 (helper)

Default registration of tables_db service if no specific services selected.

if not any([args.databases, args.tables_db, args.users, args.teams, args.storage,
            args.functions, args.messaging, args.locale, args.avatars, args.sites]):
    tools_manager.register_service(Service(TablesDB(client), "tables_db"))

Appwrite MCP Server