[AI-6713] Migrate to registerTool() API and add _meta types

[netanelavr]

What Changed

1. New Type Interfaces (angie-annotations.ts)

• AngieToolMeta - Interface for custom Angie metadata that should be placed in the _meta field:

  • angie/requiredResources
  • angie/modelPreferences
  • angie/extendedTimeout

• AngieToolAnnotations - Interface for standard MCP annotations that stay in annotations:

  • title
  • destructiveHint
  • readOnlyHint

2. Demo Server Migration (demo-mcp-server.ts)

Migrated all 4 tools from deprecated server.tool() to new server.registerTool() API:

Before:

server.tool(name, description, inputSchema, handler)

After:

server.registerTool(name, { description, inputSchema, annotations }, handler)

3. Tests

Added type validation tests for the new interfaces.

Backward Compatibility

This is a non-breaking change. Existing 3rd party integrations will continue to work:

• The deprecated .tool() API still functions (just not recommended)
• The elementor-ai frontend merges annotations from both old and new locations
• Backend continues to receive annotations in the expected format

Type of Change

• Refactor (non-breaking change — structural only)
• Documentation/Types update

Made with Cursor

✨ PR Description

Purpose: Migrate MCP server tool registration from deprecated tool() method to registerTool() API and separate standard annotations from custom Angie metadata using _meta field.

Main changes:

• Replaced server.tool() calls with server.registerTool() API, restructuring tool definitions to use inputSchema and annotations fields
• Added AngieToolMeta and AngieToolAnnotations TypeScript interfaces to distinguish custom vendor metadata from standard MCP protocol annotations
• Updated documentation and code examples to clarify annotations belong in annotations field while Angie-specific metadata uses _meta field

Generated by LinearB AI and added by gitStream.
_{AI-generated content may contain inaccuracies. Please verify before using.
💡 Tip: You can customize your AI Description using Guidelines Learn how}

[matipojo]

Please update this doc and other relevant docs
https://github.com/elementor/angie-sdk/blob/master/docs/tool-annotations.md