# MCP server builders: OpenAI's review rules on tool annotations, and why a correct hint still isn't security — retained record

> Retained reddit record from reddit:AI_Agents.

Canonical: https://highsignal.app/data/records/b326879ff50334ae

[← sources](https://highsignal.app/data)


source: [reddit](https://highsignal.app/data/reddit) (reddit:AI_Agents)  published 2026-10-31 03:12 ingested 2026-11-01 02:36

[original source ↗](https://www.reddit.com/r/AI_Agents/comments/1xjzhqs/mcp_server_builders_openais_review_rules_on_tool/)

## retained text



```
At AGNTCon + MCPCon North America in San Jose (October 22-23), OpenAI's Thomas Sarlandie talked about what ChatGPT's plugin directory sees in MCP servers in production. InfoQ's report (October 26) says OpenAI rejects submitted servers unless every tool carries annotations, because they let ChatGPT fast-track read-only calls and confirm destructive ones.

So the part of a server that is cheapest to write is also the part a client acts on. OpenAI's developer docs spell out how to set the three hints:

\- readOnlyHint: true only when the tool cannot change state. The review guide says a tool that sends messages, runs jobs, enqueues tasks, writes logs or starts workflows is not read-only.

\- destructiveHint: true when the tool can cause irreversible or hard-to-reverse results, "even in only select modes, through default parameters, or through indirect side effects".

\- openWorldHint: true when the tool reaches the public internet or open-ended external entities, and that includes read-only web search. It's false for a bounded private account or workspace, even if that service is hosted elsewhere.

One detail from the review guide is easy to miss. The justification text in a submission doesn't override the annotation. If the server advertises readOnlyHint: false, calling the tool "functionally read-only" in the form doesn't change it. You fix the annotation on the server, deploy, rescan the tools and verify the value.

The other half is what a hint can't do. The MCP spec says clients MUST treat tool annotations as untrusted unless they come from trusted servers, and OpenAI's docs say annotations don't replace server-side authorization, input validation or confirmation for consequential actions. Accurate annotations help the client decide when to ask. They don't enforce anything.

I've put a longer version on my profile (u/shoumikgoswami): a per-tool checklist, the rescan workflow and the other production notes InfoQ reported from the talk.

Which tool in your server is hardest to classify, for example a read that also writes a log line?
```



document fetched 2026-11-01 00:19 · canonical https://reddit.com/r/AI_Agents/comments/1xjzhqs/mcp_server_builders_openais_review_rules_on_tool
