Search / io.github.simonether/kwork-mcp
protogridL0· runs locallyAccount-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace
v1.5.2 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp==1.5.2"
],
"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"
}
}
}
}claude mcp add kwork-mcp -e "KWORK_WRITES=confirm" -e "KWORK_SITE=ru" -e "KWORK_TIMEOUT=30" -e "KWORK_PERSIST_TOKEN=true" -e "KWORK_RPS_LIMIT=2" -e "KWORK_BURST_LIMIT=4" -e "KWORK_ROUTE_RPS_LIMIT=1" -e "KWORK_ROUTE_BURST_LIMIT=2" -e "KWORK_RATE_WAIT_TIMEOUT=20" -e "KWORK_AUTH_LOCK_TIMEOUT=90" -e "KWORK_READ_ATTEMPTS=3" -e "KWORK_RETRY_BACKOFF_BASE=0.5" -e "KWORK_RETRY_BACKOFF_MAX=8" -e "KWORK_CIRCUIT_FAILURE_THRESHOLD=3" -e "KWORK_CIRCUIT_OPEN_SECONDS=30" -e "KWORK_PREPARATION_TTL_SECONDS=600" -e "KWORK_WRITE_LEASE_SECONDS=120" -e "KWORK_RECONCILIATION_MIN_AGE_SECONDS=15" -e "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS=2" -e "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS=15" -e "KWORK_STATE_RETENTION_DAYS=30" -e "KWORK_LOG_LEVEL=INFO" -- uvx kwork-mcp==1.5.2[mcp_servers.kwork-mcp]
command = "uvx"
args = ["kwork-mcp==1.5.2"]
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" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kwork-mcp": {
"type": "local",
"command": [
"uvx",
"kwork-mcp==1.5.2"
],
"enabled": true,
"environment": {
"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"
}
}
}
}{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp==1.5.2"
],
"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"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=kwork-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJrd29yay1tY3A9PTEuNS4yIl0sImVudiI6eyJLV09SS19XUklURVMiOiJjb25maXJtIiwiS1dPUktfU0lURSI6InJ1IiwiS1dPUktfVElNRU9VVCI6IjMwIiwiS1dPUktfUEVSU0lTVF9UT0tFTiI6InRydWUiLCJLV09SS19SUFNfTElNSVQiOiIyIiwiS1dPUktfQlVSU1RfTElNSVQiOiI0IiwiS1dPUktfUk9VVEVfUlBTX0xJTUlUIjoiMSIsIktXT1JLX1JPVVRFX0JVUlNUX0xJTUlUIjoiMiIsIktXT1JLX1JBVEVfV0FJVF9USU1FT1VUIjoiMjAiLCJLV09SS19BVVRIX0xPQ0tfVElNRU9VVCI6IjkwIiwiS1dPUktfUkVBRF9BVFRFTVBUUyI6IjMiLCJLV09SS19SRVRSWV9CQUNLT0ZGX0JBU0UiOiIwLjUiLCJLV09SS19SRVRSWV9CQUNLT0ZGX01BWCI6IjgiLCJLV09SS19DSVJDVUlUX0ZBSUxVUkVfVEhSRVNIT0xEIjoiMyIsIktXT1JLX0NJUkNVSVRfT1BFTl9TRUNPTkRTIjoiMzAiLCJLV09SS19QUkVQQVJBVElPTl9UVExfU0VDT05EUyI6IjYwMCIsIktXT1JLX1dSSVRFX0xFQVNFX1NFQ09ORFMiOiIxMjAiLCJLV09SS19SRUNPTkNJTElBVElPTl9NSU5fQUdFX1NFQ09ORFMiOiIxNSIsIktXT1JLX1JFQ09OQ0lMSUFUSU9OX0FCU0VOQ0VfQ09ORklSTUFUSU9OUyI6IjIiLCJLV09SS19SRUNPTkNJTElBVElPTl9BQlNFTkNFX0lOVEVSVkFMX1NFQ09ORFMiOiIxNSIsIktXT1JLX1NUQVRFX1JFVEVOVElPTl9EQVlTIjoiMzAiLCJLV09SS19MT0dfTEVWRUwiOiJJTkZPIn19"
}{
"servers": {
"kwork-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kwork-mcp==1.5.2"
],
"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"
}
}
}
}{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp==1.5.2"
],
"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"
}
}
}
}extensions:
"kwork-mcp":
enabled: true
name: "kwork-mcp"
type: stdio
cmd: "uvx"
args:
- "kwork-mcp==1.5.2"
envs:
"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"
timeout: 300
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknownNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-16d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPIthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
kwork-mcp | pypi | 1.5.2 | uvx |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.simonether/kwork-mcp",
"title": "Kwork",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "1.5.2",
"packages": [
{
"version": "1.5.2",
"transport": {
"type": "stdio"
},
"identifier": "kwork-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"environmentVariables": [
{
"name": "KWORK_EXPECTED_USER_ID",
"description": "Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound"
},
{
"name": "KWORK_EXPECTED_USERNAME",
"description": "Optional second account identity check"
},
{
"name": "KWORK_WRITES",
"choices": [
"confirm",
"auto",
"off"
],
"default": "confirm",
"description": "Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only"
},
{
"name": "KWORK_SITE",
"choices": [
"ru",
"com"
],
"default": "ru",
"description": "Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange"
},
{
"name": "KWORK_TIMEOUT",
"default": "30",
"description": "Kwork request timeout in seconds (1-120)"
},
{
"name": "KWORK_STATE_DIR",
"description": "Absolute private directory shared by gateway processes for the same account"
},
{
"name": "KWORK_PERSIST_TOKEN",
"default": "true",
"description": "Use the verified account-scoped credential store; required for normal server startup"
},
{
"name": "KWORK_RPS_LIMIT",
"default": "2",
"description": "Shared account-level token refill rate"
},
{
"name": "KWORK_BURST_LIMIT",
"default": "4",
"description": "Shared account-level token bucket capacity"
},
{
"name": "KWORK_ROUTE_RPS_LIMIT",
"default": "1",
"description": "Shared per-route token refill rate"
},
{
"name": "KWORK_ROUTE_BURST_LIMIT",
"default": "2",
"description": "Shared per-route token bucket capacity"
},
{
"name": "KWORK_RATE_WAIT_TIMEOUT",
"default": "20",
"description": "Maximum seconds to wait for shared rate-limit admission"
},
{
"name": "KWORK_AUTH_LOCK_TIMEOUT",
"default": "90",
"description": "Maximum seconds to wait for account credential-store authentication coordination"
},
{
"name": "KWORK_READ_ATTEMPTS",
"default": "3",
"description": "Maximum attempts for retry-safe read requests only"
},
{
"name": "KWORK_RETRY_BACKOFF_BASE",
"default": "0.5",
"description": "Initial retry backoff for retry-safe reads, in seconds"
},
{
"name": "KWORK_RETRY_BACKOFF_MAX",
"default": "8",
"description": "Maximum retry backoff for retry-safe reads, in seconds"
},
{
"name": "KWORK_CIRCUIT_FAILURE_THRESHOLD",
"default": "3",
"description": "Shared route failures before opening the circuit"
},
{
"name": "KWORK_CIRCUIT_OPEN_SECONDS",
"default": "30",
"description": "Base shared circuit-open interval in seconds"
},
{
"name": "KWORK_PREPARATION_TTL_SECONDS",
"default": "600",
"description": "Safe write preparation lifetime"
},
{
"name": "KWORK_WRITE_LEASE_SECONDS",
"default": "120",
"description": "Durable one-writer lease duration in seconds"
},
{
"name": "KWORK_RECONCILIATION_MIN_AGE_SECONDS",
"default": "15",
"description": "Minimum age before ambiguous-write read-back (1-300 seconds)"
},
{
"name": "KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS",
"default": "2",
"description": "Complete absent observations required before a terminal result"
},
{
"name": "KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS",
"default": "15",
"description": "Minimum interval between absent observations (1-300 seconds)"
},
{
"name": "KWORK_STATE_RETENTION_DAYS",
"default": "30",
"description": "Retention for terminal durable write records"
},
{
"name": "KWORK_LOG_LEVEL",
"default": "INFO",
"description": "Gateway stderr log level: DEBUG, INFO, WARNING or ERROR"
}
]
}
],
"repository": {
"url": "https://github.com/simonether/kwork-mcp",
"source": "github"
},
"websiteUrl": "https://github.com/simonether/kwork-mcp",
"description": "Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace"
}