Back to Browse

Kwork MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace

About

Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved).

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are boundOptional

Environment variable: KWORK_EXPECTED_USER_ID

Optional second account identity checkOptional

Environment variable: KWORK_EXPECTED_USERNAME

Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-onlyOptional

Environment variable: KWORK_WRITES

Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchangeOptional

Environment variable: KWORK_SITE

Kwork request timeout in seconds (1-120)Optional

Environment variable: KWORK_TIMEOUT

Absolute private directory shared by gateway processes for the same accountOptional

Environment variable: KWORK_STATE_DIR

Use the verified account-scoped credential store; required for normal server startupOptional

Environment variable: KWORK_PERSIST_TOKEN

Shared account-level token refill rateOptional

Environment variable: KWORK_RPS_LIMIT

Shared account-level token bucket capacityOptional

Environment variable: KWORK_BURST_LIMIT

Shared per-route token refill rateOptional

Environment variable: KWORK_ROUTE_RPS_LIMIT

Shared per-route token bucket capacityOptional

Environment variable: KWORK_ROUTE_BURST_LIMIT

Maximum seconds to wait for shared rate-limit admissionOptional

Environment variable: KWORK_RATE_WAIT_TIMEOUT

Maximum seconds to wait for account credential-store authentication coordinationOptional

Environment variable: KWORK_AUTH_LOCK_TIMEOUT

Maximum attempts for retry-safe read requests onlyOptional

Environment variable: KWORK_READ_ATTEMPTS

Initial retry backoff for retry-safe reads, in secondsOptional

Environment variable: KWORK_RETRY_BACKOFF_BASE

Maximum retry backoff for retry-safe reads, in secondsOptional

Environment variable: KWORK_RETRY_BACKOFF_MAX

Shared route failures before opening the circuitOptional

Environment variable: KWORK_CIRCUIT_FAILURE_THRESHOLD

Base shared circuit-open interval in secondsOptional

Environment variable: KWORK_CIRCUIT_OPEN_SECONDS

Safe write preparation lifetimeOptional

Environment variable: KWORK_PREPARATION_TTL_SECONDS

Durable one-writer lease duration in secondsOptional

Environment variable: KWORK_WRITE_LEASE_SECONDS

Minimum age before ambiguous-write read-back (1-300 seconds)Optional

Environment variable: KWORK_RECONCILIATION_MIN_AGE_SECONDS

Complete absent observations required before a terminal resultOptional

Environment variable: KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS

Minimum interval between absent observations (1-300 seconds)Optional

Environment variable: KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS

Retention for terminal durable write recordsOptional

Environment variable: KWORK_STATE_RETENTION_DAYS

Gateway stderr log level: DEBUG, INFO, WARNING or ERROROptional

Environment variable: KWORK_LOG_LEVEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-simonether-kwork-mcp": {
      "env": {
        "KWORK_SITE": "your-kwork-site-here",
        "KWORK_WRITES": "your-kwork-writes-here",
        "KWORK_TIMEOUT": "your-kwork-timeout-here",
        "KWORK_LOG_LEVEL": "your-kwork-log-level-here",
        "KWORK_RPS_LIMIT": "your-kwork-rps-limit-here",
        "KWORK_STATE_DIR": "your-kwork-state-dir-here",
        "KWORK_BURST_LIMIT": "your-kwork-burst-limit-here",
        "KWORK_PERSIST_TOKEN": "your-kwork-persist-token-here",
        "KWORK_READ_ATTEMPTS": "your-kwork-read-attempts-here",
        "KWORK_ROUTE_RPS_LIMIT": "your-kwork-route-rps-limit-here",
        "KWORK_EXPECTED_USER_ID": "your-kwork-expected-user-id-here",
        "KWORK_AUTH_LOCK_TIMEOUT": "your-kwork-auth-lock-timeout-here",
        "KWORK_EXPECTED_USERNAME": "your-kwork-expected-username-here",
        "KWORK_RATE_WAIT_TIMEOUT": "your-kwork-rate-wait-timeout-here",
        "KWORK_RETRY_BACKOFF_MAX": "your-kwork-retry-backoff-max-here",
        "KWORK_ROUTE_BURST_LIMIT": "your-kwork-route-burst-limit-here",
        "KWORK_RETRY_BACKOFF_BASE": "your-kwork-retry-backoff-base-here",
        "KWORK_WRITE_LEASE_SECONDS": "your-kwork-write-lease-seconds-here",
        "KWORK_CIRCUIT_OPEN_SECONDS": "your-kwork-circuit-open-seconds-here",
        "KWORK_STATE_RETENTION_DAYS": "your-kwork-state-retention-days-here",
        "KWORK_PREPARATION_TTL_SECONDS": "your-kwork-preparation-ttl-seconds-here",
        "KWORK_CIRCUIT_FAILURE_THRESHOLD": "your-kwork-circuit-failure-threshold-here",
        "KWORK_RECONCILIATION_MIN_AGE_SECONDS": "your-kwork-reconciliation-min-age-seconds-here",
        "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "your-kwork-reconciliation-absence-confirmations-here",
        "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "your-kwork-reconciliation-absence-interval-seconds-here"
      },
      "args": [
        "kwork-mcp"
      ],
      "command": "uvx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!