Skip to content

docs(changelog): MCP server tool search and schema improvements #3170

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
atharvadeosthale wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(changelog): MCP server tool search and schema improvements #3170

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
16 changes: 16 additions & 0 deletions src/routes/changelog/(entries)/2026-08-13-1.markdoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
layout: changelog
title: "Better tool search and clearer schemas in the Appwrite MCP server"
date: 2026-08-13
---

The [**Appwrite MCP server**](/docs/tooling/ai/mcp-servers/api) has a set of improvements. These improvements help AI tools find the correct Appwrite tool quickly. They also help AI tools call each tool correctly on the first try.

- **Search results show enum values and object shapes**: If a parameter accepts only some values, the search results show these values. For example, a relationship type shows `oneToOne|manyToOne|manyToMany|oneToMany`. If a parameter is an object, the search results show its keys. The model does not have to guess valid inputs.
- **Full parameter descriptions**: The server does not truncate parameter descriptions. Important details, for example query limits and formats, stay complete.
- **More accurate search results**: The tool search removes results that do not match the query. The tool search also matches different forms of the same word. The words `row` and `rows` find the same tools. A query for "read rows with pagination" finds list tools, not only single-item tools.
- **Suggestions for incorrect tool names**: If a tool name is almost correct, the error message shows the closest tool names. The model does not have to do a new search.
- **Fewer round-trips**: The result previews are larger. A typical list response fits fully in the tool result. An extra read of the results resource is not necessary.
- **Clearer errors for unparsed responses**: Appwrite can accept a write operation, but the response can fail to parse. The error message now says that the operation was probably successful. It tells the model to make sure with a get or a list call before a retry. This prevents duplicate operations.

These improvements are available on the [remote MCP server](/docs/tooling/ai/mcp-servers/api) at `https://mcp.appwrite.io/` and on the [local MCP server](/docs/advanced/self-hosting/mcp) for self-hosted instances.
Loading