Slotlock

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-27T00:22:35.007178Z",
      "publishedAt": "2026-10-27T00:22:35.007178Z",
      "statusChangedAt": "2026-10-27T00:22:35.007178Z"
    }
  },
  "server": {
    "name": "io.github.PILOTAAI/slotlock",
    "title": "Slotlock",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.3.0",
    "packages": [
      {
        "transport": {
          "url": "http://localhost:{PORT}/mcp",
          "type": "streamable-http",
          "headers": [
            {
              "name": "Authorization",
              "value": "Bearer {token}",
              "isSecret": true,
              "variables": {
                "token": {
                  "isSecret": true,
                  "isRequired": true,
                  "description": "SLOTLOCK_AUTH_TOKEN, or an API key (slk_...), which acts in the tenant it was created in."
                }
              },
              "isRequired": true,
              "description": "A bearer the server accepts: SLOTLOCK_AUTH_TOKEN, or an API key from `slotlock key create` (slk_...)."
            }
          ]
        },
        "identifier": "ghcr.io/pilotaai/slotlock:0.3.0",
        "runtimeHint": "docker",
        "registryType": "oci",
        "packageArguments": [
          {
            "type": "positional",
            "value": "serve",
            "description": "Serve MCP and A2A over HTTP."
          },
          {
            "type": "positional",
            "value": "--migrate",
            "description": "Apply the schema first (idempotent)."
          }
        ],
        "runtimeArguments": [
          {
            "name": "-p",
            "type": "named",
            "value": "127.0.0.1:{PORT}:{PORT}",
            "variables": {
              "PORT": {
                "format": "number",
                "default": "8080",
                "isRequired": true,
                "description": "The same value as the PORT environment variable."
              }
            },
            "description": "Publish the server on this machine's loopback interface only."
          }
        ],
        "environmentVariables": [
          {
            "name": "DATABASE_URL",
            "isSecret": true,
            "isRequired": true,
            "description": "postgres:// URL of a PostgreSQL 16 or newer database the container can reach, as a role that is not a superuser and has no BYPASSRLS: serve refuses one, since row-level security would not confine it. Without SLOTLOCK_MIGRATE_DATABASE_URL this role also applies the schema, so it must be able to create it."
          },
          {
            "name": "SLOTLOCK_AUTH_TOKEN",
            "isSecret": true,
            "description": "Optional bearer token for SLOTLOCK_TENANT, with read and write (never admin): at least 32 random characters (openssl rand -hex 32). Leave it unset to accept only API keys (slotlock key create)."
          },
          {
            "name": "SLOTLOCK_CONFIRMATION_SECRET",
            "isSecret": true,
            "description": "Signs pending write confirmations: at least 32 random characters, different from the token. Required unless SLOTLOCK_CONFIRM_WRITES is none."
          },
          {
            "name": "PORT",
            "format": "number",
            "default": "8080",
            "description": "Port the server listens on inside the container."
          },
          {
            "name": "SLOTLOCK_MIGRATE_DATABASE_URL",
            "isSecret": true,
            "description": "postgres:// URL of the schema owner. When set, migration runs as this role and grants the DATABASE_URL role only what it needs at runtime."
          },
          {
            "name": "SLOTLOCK_CONFIRM_WRITES",
            "default": "none",
            "description": "Writes that wait for a person to confirm them: none, all, or a comma-separated list of slotlock_create_event, slotlock_update_event, slotlock_delete_event. Clients without MCP 2026-07-28 form elicitation have guarded writes refused."
          },
          {
            "name": "SLOTLOCK_AVAILABILITY",
            "description": "JSON array of weekly bookable-hours rules, e.g. [{\"rrule\":\"FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR\",\"startMinutes\":540,\"durationMinutes\":480}]. Without rules no slot is ever offered."
          },
          {
            "name": "SLOTLOCK_REST_API",
            "default": "on",
            "description": "on: also serve the tools as a REST API under /v1, and the application API (resources, bookable hours, holds, reservations, coverage, maintenance) for admin keys, described by an OpenAPI 3.1 document at /openapi.json. Writes that wait for confirmation answer 428 there. off: MCP and A2A only."
          },
          {
            "name": "SLOTLOCK_TENANT",
            "default": "default",
            "description": "The tenant SLOTLOCK_AUTH_TOKEN acts in; API keys act in their own tenant."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/PILOTAAI/slotlock",
      "source": "github"
    },
    "websiteUrl": "https://slotlock.pylota.io",
    "description": "Calendars for AI agents: free/busy, next free slot, and bookings PostgreSQL never double-books."
  }
}