What can you do with this server?

This MCP server provides 28 tools to interact with the Kwork freelance marketplace, enabling you to manage your freelance activity end-to-end. Profile Management * View your profile details (rating, balance, order stats) and connects balance * Look up any user by ID or username, or search users by name Projects * Browse and search projects with filters (category, budget range, hiring rate, max offers, text query) * Get detailed project info by ID and view exchange marketplace statistics Offers * List your submitted offers, view offer details, submit new offers (costs 1 connect), and delete existing ones Orders * List your seller orders, view detailed order info (description, stages, history), and submit completed work for buyer approval Dialogs & Messages * List conversations with unread counts, read messages in a dialog, send/edit/delete messages, and mark dialogs as read Kworks (Services) * List your kworks grouped by status, view kwork details (reviews, FAQ), and activate or pause kworks Categories * Browse the full category tree and view your favorite categories Notifications * Access your notifications for orders, messages, and system alerts

How do I use kwork-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@kwork-mcp find Python programming projects" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

kwork-mcp

by simonether

Overview Schema Related Servers Score Discussions

Python

Remote

PyPI Downloads Python 3.12+ License: MIT Ruff MCP

MCP server that exposes 28 tools for the Kwork freelance marketplace — browse projects, submit offers, manage orders, send messages, and more.

Built with FastMCP 3.x and pykwork.

Highlights

Tool annotations — read-only, write, and destructive hints for safer agent interactions
Input validation — all parameters validated before API calls
Auto-relogin — automatic session refresh on 401 errors
Error sanitization — internal details stay in logs, not in agent responses
Rate limiting — built-in sliding window rate limiter

Related MCP server: upwork-mcp

Setup

Requirements

uv
Kwork account (login/password or API token)

Install

When using uv no specific installation is needed. We will use uvx to directly run kwork-mcp.

Alternatively, install via pip:

pip install kwork-mcp

Or from source:

git clone https://github.com/simonether/kwork-mcp.git
cd kwork-mcp
uv sync

Configure

Variable	Required	Default	Description
`KWORK_LOGIN`	yes*	—	Kwork login
`KWORK_PASSWORD`	yes*	—	Kwork password
`KWORK_TOKEN`	yes*	—	Auth token (skips login)
`KWORK_PHONE_LAST`	no	—	Last 4 digits of phone (2FA)
`KWORK_PROXY_URL`	no	—	Proxy (HTTP / SOCKS4 / SOCKS5)
`KWORK_TIMEOUT`	no	`30`	Request timeout in seconds
`KWORK_RPS_LIMIT`	no	`2`	Requests per second
`KWORK_BURST_LIMIT`	no	`5`	Burst limit
`KWORK_TOKEN_FILE`	no	`~/.kwork_token`	Token persistence path

*Either KWORK_TOKEN or both KWORK_LOGIN + KWORK_PASSWORD.

Auth priority: KWORK_TOKEN env → saved token file → fresh login.

Proxy URL formats:

KWORK_PROXY_URL=http://proxy.example.com:8080
KWORK_PROXY_URL=socks5://proxy.example.com:1080
KWORK_PROXY_URL=socks5://user:password@proxy.example.com:1080

Usage

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kwork": {
      "command": "uvx",
      "args": ["kwork-mcp"],
      "env": {
        "KWORK_LOGIN": "your_login",
        "KWORK_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code

claude mcp add kwork -e KWORK_LOGIN=your_login -e KWORK_PASSWORD=your_password -- uvx kwork-mcp

VS Code

Add to .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "kwork": {
        "command": "uvx",
        "args": ["kwork-mcp"],
        "env": {
          "KWORK_LOGIN": "your_login",
          "KWORK_PASSWORD": "your_password"
        }
      }
    }
  }
}

stdio

uvx kwork-mcp

Tools

Tool	Description
`get_me`	Current user profile, rating, balance
`get_connects`	Connect count for exchange offers
`get_user_info`	Public user info by ID
`search_users`	Search users by name or username

Tool	Description
`list_projects`	Browse exchange projects with filters
`get_project`	Project details by ID
`search_projects`	Search by text query
`get_exchange_info`	Exchange marketplace stats

Tool	Description
`list_my_offers`	Your exchange offers
`get_offer`	Offer details by ID
`submit_offer`	Submit offer to a project (costs 1 connect)
`delete_offer`	Delete an offer

Tool	Description
`list_worker_orders`	Seller orders (all statuses)
`get_order_details`	Order details by ID
`send_order_for_approval`	Submit work for buyer review

Tool	Description
`list_dialogs`	Conversations with latest messages
`get_dialog`	Messages by username
`send_message`	Send direct message
`edit_message`	Edit a sent message by ID
`delete_message`	Delete a sent message by ID
`mark_dialog_read`	Mark as read

Tool	Description
`list_my_kworks`	Your services grouped by status
`get_kwork_details`	Kwork details by ID
`start_kwork`	Activate a paused kwork
`pause_kwork`	Pause an active kwork

Tool	Description
`list_categories`	Full category tree
`get_favorite_categories`	User's favorite categories

Tool	Description
`list_notifications`	User notifications

Development

uv sync --dev
uv run python -m pytest tests/ -x -v --cov=kwork_mcp --cov-report=term-missing
uv run ruff check .
uv run ruff format --check .

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2wRelease cycle

11Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/simonether/kwork-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server