servicenow-atlas: Skill for Claude Code

When to use

• User asks to "add a new tool", "create a tool for X", "expose Y as an MCP tool"
• User is building a new capability that needs to be callable by an LLM
• User wants to understand the existing tool registration pattern

Not for

• General code changes outside tool definitions
• Modifying the embedder or chunker internals
• Changing the MCP server lifecycle (startup, shutdown, transport)

Prerequisites

Read the existing tool implementations in:

• atlas/rag_server.py — tools on the RAG server (semantic search, etc.)
• atlas/fs_server.py — tools on the filesystem server (read, list, search, etc.)

Workflow

1. Locate the right server file

Tool belongs to	Server file
Document search / RAG	atlas/rag_server.py
File listing / reading	atlas/fs_server.py
Build / maintenance	Consider a new server or atlas/doctor.py

2. Follow the existing pattern

Each tool has three parts in the server file:

a) Tool docstring + @server.list_tools() handler

@server.list_tools()
async def list_tools() -> list[Tool]:
    return [
        # existing tools ...
        Tool(
            name="your_tool_name",
            description="What the tool does — be specific",
            inputSchema={
                "type": "object",
                "properties": {
                    "param_name": {
                        "type": "string",
                        "description": "What this parameter is for",
                    },
                },
                "required": ["param_name"],
            },
        ),
    ]

• Tool names: snake_case, conventionally matching the function name.
• Descriptions: written for an LLM reader. Include edge cases, defaults, and example values.
• Parameters: use JSON Schema types (string, integer, array, etc.). Mark required explicitly.

b) The @server.call_tool() handler branch

@server.call_tool()
async def call_tool(name: str, arguments: dict) -> list[TextContent]:
    if name == "your_tool_name":
        result = await your_handler(arguments)
        return [TextContent(type="text", text=result)]
    elif name == "existing_tool":
        ...