Skip to content

Conversation

@bryankthompson
Copy link

Summary

Adds complete MCP tool annotations to all 8 tools to help LLMs better understand tool behavior and enable clients to make safer decisions about tool execution.

Changes

New annotations added (5 tools):

  • company_research_exa: Company Research
  • crawling_exa: Web Crawling
  • linkedin_search_exa: LinkedIn Search
  • deep_researcher_start: Start Deep Research
  • deep_researcher_check: Check Deep Research Status

Enhanced annotations (3 tools):

Added title and openWorldHint to existing annotations:

  • web_search_exa: Web Search
  • deep_search_exa: Deep Search
  • get_code_context_exa: Code Context Search

Annotation details for all tools:

Tool Title readOnlyHint openWorldHint idempotentHint
web_search_exa Web Search true true true
deep_search_exa Deep Search true true true
get_code_context_exa Code Context Search true true true
company_research_exa Company Research true true true
crawling_exa Web Crawling true true true
linkedin_search_exa LinkedIn Search true true true
deep_researcher_start Start Deep Research true true false
deep_researcher_check Check Deep Research Status true true true

Why This Matters

  • Safety: Clients can auto-approve read-only operations without user confirmation
  • External API awareness: openWorldHint: true indicates tools access external systems
  • UI improvements: title provides human-readable names for display
  • Idempotency: Helps clients understand retry behavior (all idempotent except deep_researcher_start)

Testing

  • Build passes (npm run build)
  • All 8 tools have complete annotations
  • Annotations visible in bundled output

🤖 Generated with Claude Code

Add complete MCP tool annotations to all 8 tools:
- Added title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint
- All tools are read-only (web searches/fetches)
- All tools have openWorldHint=true (external API calls)

Tools annotated:
- web_search_exa: Web Search
- deep_search_exa: Deep Search
- get_code_context_exa: Code Context Search
- company_research_exa: Company Research
- crawling_exa: Web Crawling
- linkedin_search_exa: LinkedIn Search
- deep_researcher_start: Start Deep Research
- deep_researcher_check: Check Deep Research Status

This improves tool safety metadata for MCP clients.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@vercel
Copy link

vercel bot commented Dec 29, 2025

@web-flow is attempting to deploy a commit to the Exa Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants