# destructiveHint: false on a write: the platforms word this differently

**OpenAI says destructiveHint: false is right for additive writes with no destructive or irreversible effect; Anthropic asks for destructiveHint: true on tools that modify or delete data and does not say whether a pure create counts, so false is defensible only for writes that purely add.**

Check `anthropic-hint-platforms-differ` · Anthropic connector directory · default severity: attention · rubric 2.1.0. Last verified against Anthropic connector pre-submission checklist on 2026-11-18.

## What fails

This write tool sets destructiveHint: false. OpenAI says false is right for "additive writes without destructive or irreversible effects". Anthropic's checklist asks for destructiveHint: true on "tools that modify or delete data", and does not say whether a pure create counts as modifying. Neither text settles it, so this is not graded as blocking. If the tool can overwrite, cancel, revoke or send something irreversible, it is destructive on both platforms.

## The rule

> Every tool must include a `title` and the applicable hint: `readOnlyHint: true` for read-only tools, and `destructiveHint: true` for tools that modify or delete data.

Source: [Anthropic connector pre-submission checklist](https://claude.com/docs/connectors/building/review-criteria#provide-tool-annotations)

## How to fix it

Keep destructiveHint: false only if the tool purely adds (a new record, a new comment) and cannot overwrite or delete. Otherwise set it to true. If a reviewer asks, the OpenAI wording supports false for additive writes.

1. Keep destructiveHint: false only if the tool purely adds (a new record, a new comment) and cannot overwrite, cancel, revoke or send.
2. If it can overwrite or has an irreversible effect, set destructiveHint: true.
3. If a reviewer asks, cite OpenAI’s wording for additive writes.

### TypeScript SDK

```ts
import { McpServer } from '@modelcontextprotocol/server';
import * as z from 'zod';

const server = new McpServer({ name: 'issues', version: '1.0.0' });

server.registerTool(
  'add_comment',
  {
    title: 'Add comment',
    description: 'Add a new comment to one issue; never edits or removes existing comments. Use when the user asks to reply on an issue.',
    inputSchema: z.strictObject({
      issue_id: z.string().describe('Issue ID, for example ISS-42'),
      comment_body: z.string().describe('Comment text in Markdown'),
    }),
    annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
  },
  async ({ issue_id, comment_body }) => ({ content: [{ type: 'text', text: 'Done' }] }),
);
```

### Python SDK

```python
from typing import Annotated

from pydantic import Field
from mcp.server.mcpserver import MCPServer
from mcp.types import ToolAnnotations

server = MCPServer("issues")

@server.tool(
    title="Add comment",
    annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False, openWorldHint=False),
)
def add_comment(
    issue_id: Annotated[str, Field(description="Issue ID, for example ISS-42")],
    comment_body: Annotated[str, Field(description="Comment text in Markdown")],
) -> str:
    """Add a new comment to one issue; never edits or removes existing comments. Use when the user asks to reply on an issue."""
    return "Done"
```

## Questions

### Will Claude reject destructiveHint: false on a create tool?

The checklist does not say. That is why the checker marks it for attention, not as blocking. A tool that only adds data is the case OpenAI explicitly calls non-destructive.

### What does destructiveHint change for the user?

Clients use it to decide whether to ask before a call. With false, an additive write may run with less friction; with true, the user confirms each call.

## Related checks

- [Every tool carries the applicable hint](https://isokron.ai/mcp-check/checks/anthropic-hint)
- [Deleting tools are not marked non-destructive](https://isokron.ai/mcp-check/checks/annot-delete-marked-safe)
- [readOnlyHint, destructiveHint and openWorldHint are explicit booleans](https://isokron.ai/mcp-check/checks/openai-hints-explicit)
- [MCP tool annotations](https://isokron.ai/mcp-check/checks/annotations)

## Further reading

- [MCP write safety: what annotations cannot do](https://isokron.ai/write-safety)

Counts toward: Anthropic connector directory.

Rubric: https://isokron.ai/mcp-check/rubric

Check your tool list: https://isokron.ai/mcp-check
