Skip to content

feat: add MCP tool annotations for all 4 tools#86

Open
bryankthompson wants to merge 1 commit into
tavily-ai:mainfrom
bryankthompson:feat/add-tool-annotations
Open

feat: add MCP tool annotations for all 4 tools#86
bryankthompson wants to merge 1 commit into
tavily-ai:mainfrom
bryankthompson:feat/add-tool-annotations

Conversation

@bryankthompson
Copy link
Copy Markdown

@bryankthompson bryankthompson commented Dec 30, 2025

Summary

Adds MCP tool annotations (readOnlyHint) to all 4 tools to help LLMs understand tool behavior and enable clients to auto-approve safe operations.

Changes

  • Added readOnlyHint: true to all 4 tools:
    • tavily-search - Web search (read-only)
    • tavily-extract - Content extraction (read-only)
    • tavily-crawl - Web crawling (read-only)
    • tavily-map - Site mapping (read-only)

Why This Matters

Tool annotations are part of the MCP specification that enable:

  • Clients to auto-approve safe (read-only) operations
  • Better tool discovery and filtering
  • Improved LLM decision-making about tool usage

Testing

  • Server builds successfully (npm run build)
  • Annotation values match actual tool behavior (all read-only)

🤖 Generated with Claude Code


Note

Marks all tools as read-only to improve client auto-approval and tool usage signaling per MCP spec.

  • Added annotations: { readOnlyHint: true } to tavily-search, tavily-extract, tavily-crawl, and tavily-map definitions in src/index.ts.

Written by Cursor Bugbot for commit 06aed30. This will update automatically on new commits. Configure here.

Added readOnlyHint annotations to all tools:
- tavily-search: read-only web search
- tavily-extract: read-only content extraction
- tavily-crawl: read-only web crawling
- tavily-map: read-only site mapping

These annotations help MCP clients understand tool behavior and
enable auto-approval of safe (read-only) operations.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
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