Critical failure: The single tool 'API-{operationId}' has NO visible input schema definition in the source code. The schema property shows an empty object with additionalProperties=true, which violates the constraint that parameters must have type definitions. Description is generic boilerplate ('Dynamically generated from OpenAPI specification'), under 20 chars of actionable guidance. No parameter descriptions, no output schema documentation, no error handling guidance. Tool names are not verb-noun patterns; they are templated placeholders. This server exposes raw OpenAPI operations without abstraction, forcing LLMs to reason about unfamiliar API semantics. No evidence of schema validation, input sanitization, or recovery guidance.

• Generate explicit tool definitions for each Notion API operation (e.g., 'create_database', 'query_database', 'update_page', 'get_block'). Use verb-noun naming. Do NOT expose raw OpenAPI operationIds.
• For each generated tool, extract and document the input schema from the OpenAPI spec: include parameter types, required fields, enums, min/max constraints, and descriptions. Populate the schema object fully, do not use additionalProperties=true.
• Write operation-specific descriptions (50-200 chars) that explain WHAT the tool does, WHEN to use it vs similar tools, and what it returns. Example: 'Create a new Notion database with specified properties. Returns database_id, created_time, and schema. Use this before querying or updating the database.'
• Document the output schema for each tool. Include all fields the agent needs for chaining (e.g., database_id, page_id, block_id). Strip verbose metadata and audit fields.
• Implement error handling that categorizes failures (retryable, user-fixable, fatal) and provides recovery hints. Example: 'Invalid database_id. Call list_databases() to find available databases.' Do not expose raw API errors.

Inferred effective spec: <=2025-11-25.

• Relies on Stateful initialize / Mcp-Session-Id (removed; protocol is stateless) - make each request self-contained