Kwork

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.simonether/kwork-mcp",
  "description": "Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace",
  "title": "Kwork",
  "repository": {
    "url": "https://github.com/simonether/kwork-mcp",
    "source": "github"
  },
  "version": "1.5.2",
  "websiteUrl": "https://github.com/simonether/kwork-mcp",
  "packages": [
    {
      "registryType": "pypi",
      "identifier": "kwork-mcp",
      "version": "1.5.2",
      "runtimeHint": "uvx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound",
          "name": "KWORK_EXPECTED_USER_ID"
        },
        {
          "description": "Optional second account identity check",
          "name": "KWORK_EXPECTED_USERNAME"
        },
        {
          "description": "Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only",
          "default": "confirm",
          "choices": [
            "confirm",
            "auto",
            "off"
          ],
          "name": "KWORK_WRITES"
        },
        {
          "description": "Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange",
          "default": "ru",
          "choices": [
            "ru",
            "com"
          ],
          "name": "KWORK_SITE"
        },
        {
          "description": "Kwork request timeout in seconds (1-120)",
          "default": "30",
          "name": "KWORK_TIMEOUT"
        },
        {
          "description": "Absolute private directory shared by gateway processes for the same account",
          "name": "KWORK_STATE_DIR"
        },
        {
          "description": "Use the verified account-scoped credential store; required for normal server startup",
          "default": "true",
          "name": "KWORK_PERSIST_TOKEN"
        },
        {
          "description": "Shared account-level token refill rate",
          "default": "2",
          "name": "KWORK_RPS_LIMIT"
        },
        {
          "description": "Shared account-level token bucket capacity",
          "default": "4",
          "name": "KWORK_BURST_LIMIT"
        },
        {
          "description": "Shared per-route token refill rate",
          "default": "1",
          "name": "KWORK_ROUTE_RPS_LIMIT"
        },
        {
          "description": "Shared per-route token bucket capacity",
          "default": "2",
          "name": "KWORK_ROUTE_BURST_LIMIT"
        },
        {
          "description": "Maximum seconds to wait for shared rate-limit admission",
          "default": "20",
          "name": "KWORK_RATE_WAIT_TIMEOUT"
        },
        {
          "description": "Maximum seconds to wait for account credential-store authentication coordination",
          "default": "90",
          "name": "KWORK_AUTH_LOCK_TIMEOUT"
        },
        {
          "description": "Maximum attempts for retry-safe read requests only",
          "default": "3",
          "name": "KWORK_READ_ATTEMPTS"
        },
        {
          "description": "Initial retry backoff for retry-safe reads, in seconds",
          "default": "0.5",
          "name": "KWORK_RETRY_BACKOFF_BASE"
        },
        {
          "description": "Maximum retry backoff for retry-safe reads, in seconds",
          "default": "8",
          "name": "KWORK_RETRY_BACKOFF_MAX"
        },
        {
          "description": "Shared route failures before opening the circuit",
          "default": "3",
          "name": "KWORK_CIRCUIT_FAILURE_THRESHOLD"
        },
        {
          "description": "Base shared circuit-open interval in seconds",
          "default": "30",
          "name": "KWORK_CIRCUIT_OPEN_SECONDS"
        },
        {
          "description": "Safe write preparation lifetime",
          "default": "600",
          "name": "KWORK_PREPARATION_TTL_SECONDS"
        },
        {
          "description": "Durable one-writer lease duration in seconds",
          "default": "120",
          "name": "KWORK_WRITE_LEASE_SECONDS"
        },
        {
          "description": "Minimum age before ambiguous-write read-back (1-300 seconds)",
          "default": "15",
          "name": "KWORK_RECONCILIATION_MIN_AGE_SECONDS"
        },
        {
          "description": "Complete absent observations required before a terminal result",
          "default": "2",
          "name": "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS"
        },
        {
          "description": "Minimum interval between absent observations (1-300 seconds)",
          "default": "15",
          "name": "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS"
        },
        {
          "description": "Retention for terminal durable write records",
          "default": "30",
          "name": "KWORK_STATE_RETENTION_DAYS"
        },
        {
          "description": "Gateway stderr log level: DEBUG, INFO, WARNING or ERROR",
          "default": "INFO",
          "name": "KWORK_LOG_LEVEL"
        }
      ]
    }
  ]
}