Skip to content
MCP server

Kwork

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.5.2
Listing updated
6 days ago

About Kwork

Kwork is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add kwork-mcp -- uvx kwork-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "kwork-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KWORK_EXPECTED_USER_IDKwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound
  • KWORK_EXPECTED_USERNAMEOptional second account identity check
  • 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_STATE_DIRAbsolute private directory shared by gateway processes for the same account
  • 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

Pricing

Open source

Kwork FAQ

Is Kwork free?

Yes. Kwork is open source, so you can use and self-host it for free.

How do I add Kwork to Claude Code?

Run this command in your terminal: claude mcp add kwork-mcp -- uvx kwork-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers