Skip to content

Add tool icons metadata (SEP-973, MCP spec 2025-11-25) #36

@alexei-led

Description

@alexei-led

Summary

MCP spec 2025-11-25 (SEP-973) allows servers to expose icons as metadata for tools, resources, resource templates, and prompts. This improves UX in MCP clients that render tool lists.

Spec Reference

Current State

No icons set on any tools, resources, or prompts.

Required Changes

  1. Check FastMCP API — does @mcp.tool() / @mcp.resource() / @mcp.prompt() support an icon parameter? Check ToolAnnotations or tool registration for icon support.

  2. Add icons to tools:

    • aws_cli_help — 📖 or a help/docs icon
    • aws_cli_pipeline — ⚡ or a terminal/CLI icon
  3. Add icons to resources (from resources.py):

    • AWS profiles → 👤
    • AWS regions → 🌍
    • AWS config → ⚙️
  4. Add icons to prompts (from prompts.py)

Icon Format

Per spec, icons can be:

  • Data URIs (data:image/svg+xml;base64,...)
  • HTTPS URLs
  • Emoji (check if FastMCP supports this shorthand)

SVG data URIs are most portable. Simple AWS-themed icons would work.

Priority

Low — nice-to-have for UI polish. No functional impact.

Testing

  • Verify icons appear in tools/list, resources/list, prompts/list responses
  • Test rendering in Claude Desktop or other MCP clients

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions