Skip to content

Tools

The following MCP tools are available. Each tool is callable by an AI agent and accepts typed parameters.

get_guide_info

Returns metadata for a Norton Guide database file.

Parameters

Name Type Description
path string Absolute path to the .ng file

Returns

{
  "path": "/guides/eg.ng",
  "title": "Example Guide",
  "credits": ["Line 1", "Line 2", "", "", ""],
  "magic": "NG",
  "made_with": "Norton Guide",
  "menu_count": 3,
  "file_size": 12345,
  "is_valid": true
}

list_menus

Returns the menu structure of a Norton Guide.

Parameters

Name Type Description
path string Absolute path to the .ng file

Returns

[
  {
    "title": "Main Menu",
    "prompts": ["Topic A", "Topic B"],
    "offsets": [452, 1024]
  }
]

list_entries

Lists all entries in a Norton Guide with summary information.

Parameters

Name Type Description
path string Absolute path to the .ng file

Returns

[
  {
    "offset": 452,
    "type": "short",
    "line_count": 10,
    "first_line": "Introduction"
  }
]

read_entry

Returns the full plain-text content of the entry at a given offset.

Parameters

Name Type Description
path string Absolute path to the .ng file
offset integer Byte offset of the entry

Returns

{
  "offset": 452,
  "type": "long",
  "lines": ["First line", "Second line"],
  "see_also": [{"text": "Related topic", "offset": 2048}]
}

Follows a link in a short entry and returns the target long entry.

Parameters

Name Type Description
path string Absolute path to the .ng file
offset integer Byte offset of the short entry
line integer Zero-based line index within the short entry

Returns

{
  "source_offset": 452,
  "source_line": 2,
  "link_text": "Topic A",
  "target_offset": 1024,
  "lines": ["Content of Topic A..."],
  "see_also": []
}

search_guide

Full-text search through all entries in a Norton Guide.

Parameters

Name Type Default Description
path string Absolute path to the .ng file
query string Text to search for
case_sensitive boolean false Whether the search is case-sensitive

Returns

[
  {
    "offset": 452,
    "type": "long",
    "matching_lines": [
      {"line_index": 3, "text": "This line contains the query"}
    ]
  }
]

list_guide_files

Lists .ng files available to the server.

Parameters

Name Type Default Description
directory string (none) Restrict listing to a specific directory path

Returns

[
  {
    "path": "/guides/example.ng",
    "name": "example.ng",
    "size": 12345
  }
]