Kwork MCP Server

io.github.simonether/kwork-mcp

Repository Registry

What is the Kwork MCP server?

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

How to install Kwork

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

KWORK_EXPECTED_USER_ID
required
Verified positive Kwork user ID; required for credentialless normal server startup
KWORK_EXPECTED_USERNAME
Optional second account identity check
KWORK_ENABLE_WRITES
Explicitly enable prepare/commit writes; also requires KWORK_EXPECTED_USER_ID
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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kwork-mcp": {
      "command": "uvx",
      "args": [
        "kwork-mcp"
      ],
      "env": {
        "KWORK_EXPECTED_USER_ID": "<YOUR_KWORK_EXPECTED_USER_ID>",
        "KWORK_EXPECTED_USERNAME": "<YOUR_KWORK_EXPECTED_USERNAME>",
        "KWORK_ENABLE_WRITES": "<YOUR_KWORK_ENABLE_WRITES>",
        "KWORK_TIMEOUT": "<YOUR_KWORK_TIMEOUT>",
        "KWORK_STATE_DIR": "<YOUR_KWORK_STATE_DIR>",
        "KWORK_PERSIST_TOKEN": "<YOUR_KWORK_PERSIST_TOKEN>",
        "KWORK_RPS_LIMIT": "<YOUR_KWORK_RPS_LIMIT>",
        "KWORK_BURST_LIMIT": "<YOUR_KWORK_BURST_LIMIT>",
        "KWORK_ROUTE_RPS_LIMIT": "<YOUR_KWORK_ROUTE_RPS_LIMIT>",
        "KWORK_ROUTE_BURST_LIMIT": "<YOUR_KWORK_ROUTE_BURST_LIMIT>",
        "KWORK_RATE_WAIT_TIMEOUT": "<YOUR_KWORK_RATE_WAIT_TIMEOUT>",
        "KWORK_AUTH_LOCK_TIMEOUT": "<YOUR_KWORK_AUTH_LOCK_TIMEOUT>",
        "KWORK_READ_ATTEMPTS": "<YOUR_KWORK_READ_ATTEMPTS>",
        "KWORK_RETRY_BACKOFF_BASE": "<YOUR_KWORK_RETRY_BACKOFF_BASE>",
        "KWORK_RETRY_BACKOFF_MAX": "<YOUR_KWORK_RETRY_BACKOFF_MAX>",
        "KWORK_CIRCUIT_FAILURE_THRESHOLD": "<YOUR_KWORK_CIRCUIT_FAILURE_THRESHOLD>",
        "KWORK_CIRCUIT_OPEN_SECONDS": "<YOUR_KWORK_CIRCUIT_OPEN_SECONDS>",
        "KWORK_PREPARATION_TTL_SECONDS": "<YOUR_KWORK_PREPARATION_TTL_SECONDS>",
        "KWORK_WRITE_LEASE_SECONDS": "<YOUR_KWORK_WRITE_LEASE_SECONDS>",
        "KWORK_RECONCILIATION_MIN_AGE_SECONDS": "<YOUR_KWORK_RECONCILIATION_MIN_AGE_SECONDS>",
        "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "<YOUR_KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS>",
        "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "<YOUR_KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS>",
        "KWORK_STATE_RETENTION_DAYS": "<YOUR_KWORK_STATE_RETENTION_DAYS>",
        "KWORK_LOG_LEVEL": "<YOUR_KWORK_LOG_LEVEL>"
      }
    }
  }
}

Related MCP servers

AUTO411 Vehicle Intelligence

Identity-first automotive intelligence for vehicle resolution, specs, safety and efficiency.

HKEx Filings

Active

Access 25+ years of Hong Kong Stock Exchange regulatory filings via AI agents with live MCP gateway or local database pipeline.

Python

MIT

View repository →

Intangible Asset Valuation MCP Server

Active

Intangible asset valuation: 14 tools, 124+ formulas for IP, technology, goodwill, PPA, impairment.

Python

MIT

View repository →

Startup Valuation MCP Server

Startup valuation for AI agents: 14 tools, 80+ pre-revenue formulas.

View repository →

Vision Driven Design (VDD) MCP Server

Active

Spec-driven development MCP server: 8 phases, bi-directional traceability, 7 quality gates.

TypeScript

MIT

View repository →

SeekLink

Maintained

Local semantic search for Markdown vaults with hybrid keyword + vector retrieval, no cloud required.

Python

MIT

View repository →