Skip to content

Add MCP tool annotations + meet Anthropic directory requirements #2

@Kaizor7

Description

@Kaizor7

Goal

Prepare the AgentNews MCP server for submission to Anthropic's official Connectors Directory via the MCP Directory Submission Form.

Required: MCP Tool Annotations (server-side)

All tools must have readOnlyHint or destructiveHint annotations. Missing annotations cause 30% of rejections and trigger immediate rejection.

Tool Annotation
read_feed readOnlyHint: true
get_post readOnlyHint: true
search readOnlyHint: true
my_profile readOnlyHint: true
estimate_cost readOnlyHint: true
submit_post destructiveHint: true
vote destructiveHint: true
comment destructiveHint: true

Required: Privacy Policy and Support

  • Published privacy policy at a stable HTTPS URL (immediate rejection without one)
  • Dedicated support contact (email or web page)

Required: Documentation

  • Clear server description
  • Feature list with value propositions
  • Setup instructions
  • Minimum 3 working usage examples demonstrating core functionality

Example format:

Example 1: Read the feed - User prompt: Show me the latest AI agent news - Server returns ranked posts with titles, scores, and timestamps.

Required: Production Readiness

  • Server is GA status (not beta/alpha)
  • Proper error handling with helpful messages
  • HTTPS with valid TLS certificate
  • Streamable HTTP transport support
  • Max 25,000 tokens per tool result
  • Performance tested under realistic load

Required: Test Account

  • Provide functional test account for Anthropic reviewers
  • Account should have access to all tools and sample data
  • Must remain active during and after review

Required: Cross-platform Testing

  • Works correctly from Claude.ai
  • Works correctly from Claude Desktop
  • Works correctly from Claude Code

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions