Kwork

io.github.simonether/kwork-mcp

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

View repository →Homepage →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ],
      "env": {
        "KWORK_WRITES": "confirm",
        "KWORK_SITE": "ru",
        "KWORK_TIMEOUT": "30",
        "KWORK_PERSIST_TOKEN": "true",
        "KWORK_RPS_LIMIT": "2",
        "KWORK_BURST_LIMIT": "4",
        "KWORK_ROUTE_RPS_LIMIT": "1",
        "KWORK_ROUTE_BURST_LIMIT": "2",
        "KWORK_RATE_WAIT_TIMEOUT": "20",
        "KWORK_AUTH_LOCK_TIMEOUT": "90",
        "KWORK_READ_ATTEMPTS": "3",
        "KWORK_RETRY_BACKOFF_BASE": "0.5",
        "KWORK_RETRY_BACKOFF_MAX": "8",
        "KWORK_CIRCUIT_FAILURE_THRESHOLD": "3",
        "KWORK_CIRCUIT_OPEN_SECONDS": "30",
        "KWORK_PREPARATION_TTL_SECONDS": "600",
        "KWORK_WRITE_LEASE_SECONDS": "120",
        "KWORK_RECONCILIATION_MIN_AGE_SECONDS": "15",
        "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "2",
        "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "15",
        "KWORK_STATE_RETENTION_DAYS": "30",
        "KWORK_LOG_LEVEL": "INFO"
      }
    }
  }
}
Environment variables
  • KWORK_WRITESSending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only
  • KWORK_SITEKwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange
  • KWORK_TIMEOUTKwork request timeout in seconds (1-120)
  • KWORK_PERSIST_TOKENUse the verified account-scoped credential store; required for normal server startup
  • KWORK_RPS_LIMITShared account-level token refill rate
  • KWORK_BURST_LIMITShared account-level token bucket capacity
  • KWORK_ROUTE_RPS_LIMITShared per-route token refill rate
  • KWORK_ROUTE_BURST_LIMITShared per-route token bucket capacity
  • KWORK_RATE_WAIT_TIMEOUTMaximum seconds to wait for shared rate-limit admission
  • KWORK_AUTH_LOCK_TIMEOUTMaximum seconds to wait for account credential-store authentication coordination
  • KWORK_READ_ATTEMPTSMaximum attempts for retry-safe read requests only
  • KWORK_RETRY_BACKOFF_BASEInitial retry backoff for retry-safe reads, in seconds
  • KWORK_RETRY_BACKOFF_MAXMaximum retry backoff for retry-safe reads, in seconds
  • KWORK_CIRCUIT_FAILURE_THRESHOLDShared route failures before opening the circuit
  • KWORK_CIRCUIT_OPEN_SECONDSBase shared circuit-open interval in seconds
  • KWORK_PREPARATION_TTL_SECONDSSafe write preparation lifetime
  • KWORK_WRITE_LEASE_SECONDSDurable one-writer lease duration in seconds
  • KWORK_RECONCILIATION_MIN_AGE_SECONDSMinimum age before ambiguous-write read-back (1-300 seconds)
  • KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONSComplete absent observations required before a terminal result
  • KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDSMinimum interval between absent observations (1-300 seconds)
  • KWORK_STATE_RETENTION_DAYSRetention for terminal durable write records
  • KWORK_LOG_LEVELGateway stderr log level: DEBUG, INFO, WARNING or ERROR

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
1.5.2
Registry
active
Published
10/3/2026

More Developer Tools servers

Browse all Developer Tools →

SeekLink

simonsysun

Local read-only semantic search for Markdown vaults through MCP.

Developer ToolsAdded 6 months ago

Capital.com MCP Server

SimonTarara62

Unofficial community MCP for the Capital.com Open API. Guarded two-phase trades; demo-first.

Developer ToolsAdded 4 months ago

Fundamentals MCP

SimonTarara62

Unofficial read-only MCP for fundamentals, macro & news (EDGAR + FRED + Tavily, BYO-key).

Developer ToolsAdded 4 months ago

RoamWorthy

simonwbird

Live UK caravan, motorhome and campervan search, matching, dealer stock and model research.

Developer ToolsAdded 1 month ago

Simple Commenter

simple-commenter

Search, export, triage, and manage authorized website and asset feedback in Simple Commenter.

Developer ToolsAdded 2 weeks ago

Email Verify

SimpleBusinessSuite

Verify email addresses in chat: real-time deliverability checks with a clear verdict.

Developer ToolsAdded 1 week ago

Add the badge to your site

Show visitors that Kwork is listed here — it’s also the link we check for a free listing.

Kwork — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-simonether-kwork-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Kwork — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Kwork — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-simonether-kwork-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.