check_tricky_word

Identify words commonly miscounted in text analysis by checking for tricky spelling patterns that cause character counting errors.

Instructions

Look up a specific word to see if it's a commonly miscounted word.

Args:

word (string): The word to check

Returns: Information about common mistakes if it's a tricky word, or empty if not.

Example: check_tricky_word("strawberry") → explains the 3 r's and common mistake of counting 2

Input Schema

TableJSON Schema

Name	Required	Description	Default
`word`	Yes	The word to check

Implementation Reference

src/index.ts:532-548 (handler)

The core handler function for the 'check_tricky_word' tool. It retrieves matching tricky words using getTrickyWordByName, checks if any found, formats explanation of count, positions, common mistake, and explanation if tricky, or a not-found message otherwise, and returns as text content.

async (params) => {
  const entries = getTrickyWordByName(params.word);
  const is_tricky = entries.length > 0;

  let text: string;
  if (is_tricky) {
    text = entries
      .map(e => `"${e.word}" has ${e.count} '${e.letter}'(s) at positions [${e.positions.join(', ')}].\nCommon mistake: counting ${e.common_mistake} instead.\n${e.explanation}`)
      .join('\n\n');
  } else {
    text = `"${params.word}" is not in the tricky words database. Use count_letter to analyze it.`;
  }

  return {
    content: [{ type: "text" as const, text }],
  };
}

src/index.ts:527-530 (schema)

Input schema using Zod: requires a 'word' string parameter (min length 1). Includes annotations indicating read-only, non-destructive, idempotent tool.

inputSchema: z.object({
  word: z.string().min(1).describe("The word to check"),
}).strict(),
annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },

src/index.ts:515-549 (registration)

The server.registerTool call that registers the 'check_tricky_word' tool, providing name, metadata/schema, and handler function.

server.registerTool(
  "check_tricky_word",
  {
    title: "Check Tricky Word",
    description: `Look up a specific word to see if it's a commonly miscounted word.

Args:
  - word (string): The word to check

Returns: Information about common mistakes if it's a tricky word, or empty if not.

Example: check_tricky_word("strawberry") → explains the 3 r's and common mistake of counting 2`,
    inputSchema: z.object({
      word: z.string().min(1).describe("The word to check"),
    }).strict(),
    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
  },
  async (params) => {
    const entries = getTrickyWordByName(params.word);
    const is_tricky = entries.length > 0;

    let text: string;
    if (is_tricky) {
      text = entries
        .map(e => `"${e.word}" has ${e.count} '${e.letter}'(s) at positions [${e.positions.join(', ')}].\nCommon mistake: counting ${e.common_mistake} instead.\n${e.explanation}`)
        .join('\n\n');
    } else {
      text = `"${params.word}" is not in the tricky words database. Use count_letter to analyze it.`;
    }

    return {
      content: [{ type: "text" as const, text }],
    };
  }
);

src/resources/tricky-words.ts:200-202 (helper)
Helper function exported from tricky-words.ts that performs case-insensitive lookup in the TRICKY_WORDS database array to find matching TrickyWord entries by word name.
```
export function getTrickyWordByName(word: string): TrickyWord[] {
  return TRICKY_WORDS.filter(w => w.word.toLowerCase() === word.toLowerCase());
}
```

MCP Character Tools