Skip to content

fix(tools): correct openWorldHint to true for web-facing tools#350

Open
serhiizghama wants to merge 1 commit into
exa-labs:mainfrom
serhiizghama:fix/open-world-hint-web-tools
Open

fix(tools): correct openWorldHint to true for web-facing tools#350
serhiizghama wants to merge 1 commit into
exa-labs:mainfrom
serhiizghama:fix/open-world-hint-web-tools

Conversation

@serhiizghama

Copy link
Copy Markdown

Problem

webSearch, webSearchAdvanced, and webFetch all have openWorldHint: false, which is incorrect per the MCP 2025-11-25 specification:

If true, this tool may interact with an "open world" of external entities. If false, the tool's domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not.

All three tools query the live web (via Exa's API), so openWorldHint: false is a spec violation that misinforms MCP clients about the tools' reach.

Closes #348

Solution

Set openWorldHint: true in the three affected tool registrations. Tools that already omit the annotation (deepSearch, companyResearch, etc.) are unaffected — their default behaviour is unchanged.

Testing

No runtime changes — annotation values only affect MCP client hints, not tool execution.

webSearch, webSearchAdvanced, and webFetch all interact with the open
internet, so openWorldHint must be true per the MCP 2025-11-25 spec:
'If true, this tool may interact with an open world of external entities.
The world of a web search tool is open.' Setting false incorrectly
signals to MCP clients that these tools operate in a closed domain.
@vercel

vercel Bot commented May 31, 2026

Copy link
Copy Markdown

@serhiizghama 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.

Incorrect use of the openWorldHint tool annotation

1 participant