naftiko: "1.0.0-alpha1"

info:
  label: Appwrite API
  description: >-
    API for the Appwrite open source backend server, providing authentication,
    database, storage, functions, and messaging services for web and mobile apps.
  tags:
    - Appwrite
    - Backend-as-a-Service
    - Open Source
    - Authentication
    - Database
  created: "2026-04-19"
  modified: "2026-04-19"

binds:
  - namespace: env
    keys:
      APPWRITE_PROJECT_ID: APPWRITE_PROJECT_ID
      APPWRITE_API_KEY: APPWRITE_API_KEY

capability:
  consumes:
    - type: http
      namespace: appwrite
      baseUri: "https://cloud.appwrite.io/v1"
      description: Appwrite Cloud API
      authentication:
        type: apikey
        header: X-Appwrite-Project
        key: "{{APPWRITE_PROJECT_ID}}"
      resources:
        - name: account
          path: /account
          description: User account management
          operations:
            - name: get-account
              method: GET
              description: Returns authenticated user account
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."

        - name: users
          path: /users
          description: Server-side user management
          operations:
            - name: list-users
              method: GET
              description: Returns a list of project users
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."
            - name: create-user
              method: POST
              description: Creates a new user account
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."
              body:
                type: json
                data:
                  userId: "{{tools.userId}}"
                  email: "{{tools.email}}"
                  password: "{{tools.password}}"
                  name: "{{tools.name}}"

        - name: databases
          path: /databases
          description: Database management
          operations:
            - name: list-databases
              method: GET
              description: Returns a list of project databases
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."

        - name: buckets
          path: /storage/buckets
          description: Storage bucket management
          operations:
            - name: list-buckets
              method: GET
              description: Returns a list of storage buckets
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."

  exposes:
    - type: mcp
      port: 9090
      namespace: appwrite-mcp
      transport: http
      tools:
        - name: list-users
          description: Lists users in the Appwrite project
          hints:
            readOnly: true
            idempotent: true
          call: "appwrite.list-users"
          outputParameters:
            - type: object
              mapping: "$."

        - name: create-user
          description: Creates a new user account in the Appwrite project
          hints:
            readOnly: false
            destructive: false
          call: "appwrite.create-user"
          with:
            userId: "tools.userId"
            email: "tools.email"
            password: "tools.password"
            name: "tools.name"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-databases
          description: Lists databases in the Appwrite project
          hints:
            readOnly: true
            idempotent: true
          call: "appwrite.list-databases"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-storage-buckets
          description: Lists storage buckets in the Appwrite project
          hints:
            readOnly: true
            idempotent: true
          call: "appwrite.list-buckets"
          outputParameters:
            - type: object
              mapping: "$."