# Appwrite MCP for AI Agents MCP > Appwrite MCP connects your AI agent directly to an open-source backend service. It lets you manage databases, audit user accounts, and monitor cloud storage resources without needing to log into the Appwrite console. You can use natural conversation to list entire database schemas, inspect user registration trends, or check system health metrics instantly. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Tags:** backend-as-a-service, authentication, database-management, cloud-storage, open-source, api-backend ## Description Stop switching between tabs and dashboards just to get a project status update. This MCP lets your AI agent act as a dedicated backend developer for your entire infrastructure. Instead of manually checking the console for data structure issues or running separate queries to see who's logged in, you simply ask your agent to look it up. Your agent handles everything: listing all databases and collecting documents from specific collections; retrieving user details to spot unusual registration spikes; or auditing storage by accessing buckets and files. It’s about getting visibility into the guts of your system through plain language. Whether you're tracking how often a cloud function runs, or just need a real-time health check across all services, this MCP gives you that control. You connect via Vinkius, giving your agent instant access to manage and audit every part of your backend infrastructure. This means you don’t have to remember complex CLI commands. Your agent handles the complexity so you can focus on what matters: building great products. ## Tools ### get_health_status Checks the overall operational health status of your Appwrite project. ### list_storage_buckets Provides a list of all configured storage buckets in your project. ### list_collections Lists the specific collections available within a chosen database. ### list_databases Retrieves an exhaustive list of all databases created in your project. ### list_documents Lists the documents contained within a specified collection for review. ### list_function_executions Retrieves recent logs and status reports for executed cloud functions. ### list_bucket_files Lists the individual files stored inside a specific storage bucket. ### list_functions Provides an inventory of all defined cloud functions in your system. ### list_users Retrieves a list of project users, allowing you to inspect account statuses. ## Prompt Examples **Prompt:** ``` What's the current status of the whole project, including users and storage? ``` **Response:** ``` **Project Health Report** * ✅ **Database Status:** Operational (3/3 databases active) * 👤 **User Accounts:** 1,245 total registered. Last 7 days saw an increase of 89 accounts. * 💾 **Storage Usage:** 4.7 GB used across 5 buckets. No buckets are nearing capacity limits. Overall status: Green. All core services are running normally. ``` **Prompt:** ``` Can you check the logs for my image resize function? ``` **Response:** ``` Retrieving logs for `resize-image`... | Run ID | Status | Duration | Notes | | :---: | :---: | :---: | :---: | | 20240612_A | Success | 150ms | Image processed correctly. | | 20240612_B | Failure | 20ms | Error: File not found at source path. | I recommend checking the file paths used for this function. ``` **Prompt:** ``` List all databases and show me the documents in 'product-catalog' ``` **Response:** ``` **Database Inventory** You have 4 active databases: 1. `production-db` (Primary data) 2. `staging-db` (Testing environment) 3. `analytics-store` (Metrics collection) 4. `user-profiles` (User metadata) --- **Contents of 'product-catalog' in production-db:** * Document ID: p1001, Title: Widget Deluxe, Status: Active * Document ID: p2055, Title: Gadget Mini, Status: Discontinued ``` ## Capabilities ### Audit Database Schemas List all available databases and retrieve specific document collections for structural analysis. ### Monitor User Activity Retrieve lists of project users to track account statuses, monitor registrations, or audit user roles. ### Manage Cloud Storage Assets List storage buckets and iterate through files inside them for a comprehensive asset inventory. ### Track Function Operations View configured cloud functions and list recent execution logs to debug performance issues. ### Assess System Health Get an immediate, real-time health status report across all connected Appwrite services. ## Use Cases ### Investigating Data Discrepancies A data scientist suspects a collection is missing records. They ask their agent to run `list_databases`, find the correct database, and then use `list_collections` followed by `list_documents` to audit the structure and verify the required data points. ### Onboarding a New Team Member An operations manager needs to know what services are running. They ask their agent to use `list_functions` and `get_health_status`. The agent responds by showing the entire service inventory and confirming that all components are online. ### Securing User Accounts A security auditor needs to check for inactive or suspicious accounts. They ask their agent to run `list_users`, which immediately returns a list of users they can then analyze for potential misuse. ### Auditing Media Assets The product owner wants to know the total size and count of stored media. The agent uses `list_storage_buckets` first, followed by `list_bucket_files`, providing a full inventory of all assets. ## Benefits - Instant system visibility: Instead of digging through multiple dashboards, you can use the `get_health_status` tool to get a single, real-time report on your project's health. - Deep data auditing: You can list all databases using `list_databases` and then inspect collections via `list_collections`, giving you immediate structural insights. - Automated user tracking: The `list_users` tool lets you monitor registration trends or check account statuses without running manual reports in the console. - Storage management confidence: By listing storage buckets (`list_storage_buckets`) and then files inside them (`list_bucket_files`), you maintain a clear, auditable asset inventory. - Debugging efficiency: You can run `list_function_executions` to quickly check recent logs for any cloud function, cutting debugging time from hours to minutes. ## How It Works The bottom line is that you use natural conversation to execute complex infrastructure commands without writing code. 1. Subscribe to this MCP on Vinkius and provide your unique Appwrite Project ID, API Key, and Endpoint credentials. 2. Connect the MCP to your preferred AI client (like Cursor or Claude). 3. Ask your agent a question like, 'What is the current health status of the project?' and let it perform the necessary backend operations. ## Frequently Asked Questions **How does the Appwrite MCP help me manage my backend infrastructure?** The Appwrite MCP gives your AI agent command-line access to all your core services. You can ask it to audit databases, check storage usage, or monitor function logs without ever leaving your chat window. It centralizes visibility into everything you build. **What kind of data can I retrieve using the Appwrite MCP?** You can get a wide range of structured data: lists of all databases and collections, user registration records, file inventories from storage buckets, and real-time project health metrics. It's comprehensive backend data. **Is the Appwrite MCP suitable for large production systems?** Yes. Because it connects to your live project credentials, you can use it to run critical audits, like checking function execution logs and monitoring user activity in a high-volume environment. **Does the Appwrite MCP help me find bugs?** Absolutely. You can ask your agent to list recent cloud function executions. This lets you quickly identify failures, check error messages, and pinpoint which services need attention for debugging. **Do I have to be a developer to use the Appwrite MCP?** No. You just need to know what data you're looking for. The agent handles the technical jargon; you talk to it like you're talking to a teammate about system status.