MCP server
Kwork
Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace
Runs locallyStatus and history
- 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-mcpAdd 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 boundKWORK_EXPECTED_USERNAMEOptional second account identity checkKWORK_WRITESSending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-onlyKWORK_SITEKwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchangeKWORK_TIMEOUTKwork request timeout in seconds (1-120)KWORK_STATE_DIRAbsolute private directory shared by gateway processes for the same accountKWORK_PERSIST_TOKENUse the verified account-scoped credential store; required for normal server startupKWORK_RPS_LIMITShared account-level token refill rateKWORK_BURST_LIMITShared account-level token bucket capacityKWORK_ROUTE_RPS_LIMITShared per-route token refill rateKWORK_ROUTE_BURST_LIMITShared per-route token bucket capacityKWORK_RATE_WAIT_TIMEOUTMaximum seconds to wait for shared rate-limit admissionKWORK_AUTH_LOCK_TIMEOUTMaximum seconds to wait for account credential-store authentication coordinationKWORK_READ_ATTEMPTSMaximum attempts for retry-safe read requests onlyKWORK_RETRY_BACKOFF_BASEInitial retry backoff for retry-safe reads, in secondsKWORK_RETRY_BACKOFF_MAXMaximum retry backoff for retry-safe reads, in secondsKWORK_CIRCUIT_FAILURE_THRESHOLDShared route failures before opening the circuitKWORK_CIRCUIT_OPEN_SECONDSBase shared circuit-open interval in secondsKWORK_PREPARATION_TTL_SECONDSSafe write preparation lifetimeKWORK_WRITE_LEASE_SECONDSDurable one-writer lease duration in secondsKWORK_RECONCILIATION_MIN_AGE_SECONDSMinimum age before ambiguous-write read-back (1-300 seconds)KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONSComplete absent observations required before a terminal resultKWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDSMinimum interval between absent observations (1-300 seconds)KWORK_STATE_RETENTION_DAYSRetention for terminal durable write recordsKWORK_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.