Skip to content

chore: annotate public MCP tool safety hints #118

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
adityaoberai wants to merge 3 commits into
base: main
Choose a base branch
from
+20 −0
Open

chore: annotate public MCP tool safety hints #118

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b0c37d6
chore: prepare ChatGPT app submission metadata
adityaoberai Sep 10, 2026
4e2d45b
chore: remove ChatGPT submission metadata
adityaoberai Sep 10, 2026
eddb555
fix: mark docs search and get_context as open-world tools
adityaoberai Sep 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions src/mcp_server_appwrite/docs_search.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,11 @@ def _load_index(self) -> bool:
def get_tool(self) -> types.Tool:
return types.Tool(
name=DOCS_TOOL_NAME,
annotations=types.ToolAnnotations(
read_only_hint=True,
open_world_hint=True,
destructive_hint=False,
),
description=(
"Search the Appwrite documentation with a natural-language query and "
"return the most relevant documentation pages with their full content. "
Expand Down
15 changes: 15 additions & 0 deletions src/mcp_server_appwrite/operator.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,6 +145,11 @@ def get_public_tools(self) -> list[types.Tool]:
tools = [
types.Tool(
name="appwrite_get_context",
annotations=types.ToolAnnotations(
read_only_hint=True,
open_world_hint=True,
destructive_hint=False,
),
description=(
"Get an adaptive Appwrite account/project context summary, including "
"available projects and per-project service counts where the current "
Expand Down Expand Up @@ -186,6 +191,11 @@ def get_public_tools(self) -> list[types.Tool]:
),
types.Tool(
name="appwrite_search_tools",
annotations=types.ToolAnnotations(
read_only_hint=True,
open_world_hint=False,
destructive_hint=False,
),
description=(
"Search the hidden Appwrite tool catalog by natural language query. "
"Matches include parameter schemas (name, type, required/optional, "
Expand Down Expand Up @@ -227,6 +237,11 @@ def get_public_tools(self) -> list[types.Tool]:
),
types.Tool(
name="appwrite_call_tool",
annotations=types.ToolAnnotations(
read_only_hint=False,
open_world_hint=True,
destructive_hint=True,
),
description=(
"Call a hidden Appwrite tool by name. Put Appwrite parameters inside `arguments`. "
"Mutating tools require confirm_write=true. Hidden Appwrite parameters accept "
Expand Down
Loading