mcp-server-appwrite 0.4 fails on startup validation for tables_db with DatabaseList parsing errors

I’m trying to use mcp-server-appwrite against Appwrite Cloud and the server authenticates successfully, but fails during startup validation when probing tables_db.

Versions

mcp-server-appwrite: 0.4
appwrite Python SDK: 17.0.0

Environment

Endpoint: https://fra.cloud.appwrite.io/v1
Running via: uvx mcp-server-appwrite

What happens

The MCP server starts, loads config, registers services, and begins startup validation. It then fails on tables_db with a parsing error for DatabaseList.

Error

TypeScript

RuntimeError: Appwrite startup validation failed during the minimal startup probe.
- tables_db: Appwrite request failed: Unable to parse response into DatabaseList: 18 validation errors for DatabaseList

databases.0.policies.0.status
  Input should be 'available', 'processing', 'deleting', 'stuck' or 'failed'
  [input_value='']

databases.0.archives.0.documentSecurity
  Input should be a valid boolean, unable to interpret input
  [input_value='']

... repeated for multiple archives/databases ...

Notes

Authentication works.
Endpoint, project ID, and API key are valid.
The crash happens only when startup validation probes tables_db.
It looks like some response fields are returned as empty strings ("") where the Python model expects enum/boolean values.

Could this be a schema mismatch between the current Cloud response and the MCP/SDK models?

TL;DR

The mcp-server-appwrite 0.4 encounters errors during startup validation for tables_db. A workaround is to use the downgraded version or update to version 0.4.1. The newer version does not recognize arguments like --users or --all, but the tool functions without arguments. Documentation will be updated accordingly.

<@486533860344201226> thanks for sharing this! goal of the startup probe was to catch invalid api key or projectid errors faster, but this seems like something else gone wrong

will spend some time to look into a fix. i wasnt really able to reproduce the issue

till then u can use the mcp by using a pinned downgraded version

Thanks for the workaround suggestion and for looking into it. If I can provide more info let me know.

also we released 0.4.1, try using that

new version works thanks a lot! But the arguments like --users or --all are not recognized anymore by the tool, without argument it started. so if that is intended, appwrite docs would need updating.