Kwork MCP Server

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

Local serverstdio

What is the Kwork MCP Server?

Kwork is an MCP integration. Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace.

Packages and local setup

The published pypi package is kwork-mcp, version 1.5.2. Its declared MCP transport is stdio.

The package declares KWORK_EXPECTED_USER_ID: Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound; KWORK_EXPECTED_USERNAME: Optional second account identity check; KWORK_WRITES: Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only; KWORK_SITE: Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange; KWORK_TIMEOUT: Kwork request timeout in seconds (1-120); KWORK_STATE_DIR: Absolute private directory shared by gateway processes for the same account; KWORK_PERSIST_TOKEN: Use the verified account-scoped credential store; required for normal server startup; KWORK_RPS_LIMIT: Shared account-level token refill rate; KWORK_BURST_LIMIT: Shared account-level token bucket capacity; KWORK_ROUTE_RPS_LIMIT: Shared per-route token refill rate; KWORK_ROUTE_BURST_LIMIT: Shared per-route token bucket capacity; KWORK_RATE_WAIT_TIMEOUT: Maximum seconds to wait for shared rate-limit admission; KWORK_AUTH_LOCK_TIMEOUT: Maximum seconds to wait for account credential-store authentication coordination; KWORK_READ_ATTEMPTS: Maximum attempts for retry-safe read requests only; KWORK_RETRY_BACKOFF_BASE: Initial retry backoff for retry-safe reads, in seconds; KWORK_RETRY_BACKOFF_MAX: Maximum retry backoff for retry-safe reads, in seconds; KWORK_CIRCUIT_FAILURE_THRESHOLD: Shared route failures before opening the circuit; KWORK_CIRCUIT_OPEN_SECONDS: Base shared circuit-open interval in seconds; KWORK_PREPARATION_TTL_SECONDS: Safe write preparation lifetime; KWORK_WRITE_LEASE_SECONDS: Durable one-writer lease duration in seconds; KWORK_RECONCILIATION_MIN_AGE_SECONDS: Minimum age before ambiguous-write read-back (1-300 seconds); KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS: Complete absent observations required before a terminal result; KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS: Minimum interval between absent observations (1-300 seconds); KWORK_STATE_RETENTION_DAYS: Retention for terminal durable write records; KWORK_LOG_LEVEL: Gateway stderr log level: DEBUG, INFO, WARNING or ERROR.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 1.5.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
KWORK_EXPECTED_USER_IDKwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are boundOptional
KWORK_EXPECTED_USERNAMEOptional second account identity checkOptional
KWORK_WRITESSending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-onlyOptional
KWORK_SITEKwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchangeOptional
KWORK_TIMEOUTKwork request timeout in seconds (1-120)Optional
KWORK_STATE_DIRAbsolute private directory shared by gateway processes for the same accountOptional
KWORK_PERSIST_TOKENUse the verified account-scoped credential store; required for normal server startupOptional
KWORK_RPS_LIMITShared account-level token refill rateOptional
KWORK_BURST_LIMITShared account-level token bucket capacityOptional
KWORK_ROUTE_RPS_LIMITShared per-route token refill rateOptional
KWORK_ROUTE_BURST_LIMITShared per-route token bucket capacityOptional
KWORK_RATE_WAIT_TIMEOUTMaximum seconds to wait for shared rate-limit admissionOptional
KWORK_AUTH_LOCK_TIMEOUTMaximum seconds to wait for account credential-store authentication coordinationOptional
KWORK_READ_ATTEMPTSMaximum attempts for retry-safe read requests onlyOptional
KWORK_RETRY_BACKOFF_BASEInitial retry backoff for retry-safe reads, in secondsOptional
KWORK_RETRY_BACKOFF_MAXMaximum retry backoff for retry-safe reads, in secondsOptional
KWORK_CIRCUIT_FAILURE_THRESHOLDShared route failures before opening the circuitOptional
KWORK_CIRCUIT_OPEN_SECONDSBase shared circuit-open interval in secondsOptional
KWORK_PREPARATION_TTL_SECONDSSafe write preparation lifetimeOptional
KWORK_WRITE_LEASE_SECONDSDurable one-writer lease duration in secondsOptional
KWORK_RECONCILIATION_MIN_AGE_SECONDSMinimum age before ambiguous-write read-back (1-300 seconds)Optional
KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONSComplete absent observations required before a terminal resultOptional
KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDSMinimum interval between absent observations (1-300 seconds)Optional
KWORK_STATE_RETENTION_DAYSRetention for terminal durable write recordsOptional
KWORK_LOG_LEVELGateway stderr log level: DEBUG, INFO, WARNING or ERROROptional