knot knot

knot.mcp

The knot.mcp library provides MCP (Model Context Protocol) tool discovery and execution. It exposes the same flat function interface in all environments — in embedded contexts (Local, MCP, Remote) routing through the server’s internal endpoint, and in External contexts connecting to the server’s /mcp endpoint via knot.apiclient config.

Functions

Function Description
list_tools() Get all available MCP tools
call_tool(name, arguments) Call an MCP tool directly
tool_search(query, max_results=10) Search for tools by keyword
execute_tool(name, arguments) Execute a discovered tool

Usage

import knot.mcp as mcp

# List all available tools
tools = mcp.list_tools()
for tool in tools:
    print(f"{tool['name']}: {tool['description']}")

# Search for tools
results = mcp.tool_search("list spaces")

# Execute a tool
spaces = mcp.execute_tool("list_spaces", {})

# Call a tool directly
response = mcp.call_tool("my_tool", {"param": "value"})

Function Details

list_tools()

Get a list of all available MCP tools, including tools from remote MCP servers if configured.

Returns: list - List of tool dicts with name, description, and parameters (JSON Schema)

tool_search(query, max_results=10)

Search for tools by keyword.

Parameters:

  • query (str): Search query
  • max_results (int, optional): Maximum results to return (default: 10)

Returns: list - Matching tools

execute_tool(name, arguments)

Execute a discovered tool.

Parameters:

  • name (str): Tool name
  • arguments (dict): Arguments to pass to the tool

Returns: any - The tool’s response, automatically decoded from JSON if applicable

call_tool(name, arguments)

Low-level tool execution. For most cases, use execute_tool() instead.

Parameters:

  • name (str): Tool name
  • arguments (dict): Arguments to pass

Returns: any - Tool response

MCP Tool Development

For creating MCP tools, use scriptling.mcp.tool for parameter access and returning results:

import scriptling.mcp.tool as tool
import knot.space as space

name = tool.get_string("name")
count = tool.get_int("count", 1)

s = space.get(name)
tool.return_object(s)

Remote Tools

Tools from remote MCP servers have a namespace prefix:

import knot.mcp as mcp

response = mcp.call_tool("ai.generate-text", {
    "prompt": "Write a hello world function",
    "max_tokens": 50
})