Kwork MCP Server
by simonetherio.github.simonether/kwork-mcpv1.5.2
Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace
context tax
queued
security
queued
cold start
queued
freshness
Active6d ago
Install Kwork MCP server
Install in Claude Code
claude mcp add kwork -- uvx kwork-mcpInstall in Cursor
{
"mcpServers": {
"kwork": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"kwork": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"kwork": {
"type": "stdio",
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"kwork": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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 |
Freshness
Active — last maintenance signal 6d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-03 · 6d ago · GitHub
Latest release
2026-10-03 · 6d ago · GitHub · v1.5.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-03 · 6d ago · official registry · v1.5.2
FAQ
›How do I install the Kwork MCP server in Claude Code?
Run: claude mcp add kwork -- uvx kwork-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Kwork require an API key?
No required environment variables are declared in its published metadata.
›Can I use Kwork as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Kwork in the official MCP registry?
Yes, as io.github.simonether/kwork-mcp.