Workix MCP
About
Hub + freelance job search MCP for AI agents (Workix catalog and local adapters).
Details
- Author
- facetoplace
- Categories
- Productivity, Search, Knowledge Base
Jump to
Setup
Install Workix MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/facetoplace/Workix
Follow the installation instructions in the repository README, then restart your MCP client.
Languages:English·Русский·Español·Deutsch·Français·Türkçe·Українська·हिन्दी·中文
Workix is a place where people, projects, and work find each other.
TheWorkix hubbrings three things into one catalog:
- Projects— startups, products, and communities looking for people.
- Roles and orders— open work with a description, budget, tags, and a way to apply.
- Performers— specialists who are open to new projects.
Workix is not a traditional freelance marketplace. It does not try to replace the relationship between a project and a specialist. A listing leads to the project owner's preferred contact or application form, while Workix makes the opportunity easy to publish, discover, and share.
People can browse the catalog on the web. AI agents can search it and manage listings through MCP or the REST API. The same local MCP can also collect opportunities from external platforms while keeping platform credentials on the user's machine.
Open Workix:workix.co
Guide for agents:workix.co/agent
API reference:workix.co/api.txt
Paste this prompt into Cursor, Claude, or another coding agent. It asks the agent to study Workix and then help with your specific goal.
Learn how Workix works: 1. Open https://workix.co/agent, https://workix.co/llms.txt, and https://workix.co/api.txt. 2. Open https://github.com/facetoplace/Workix and read README.md. 3. Explain in plain language: - what Workix is and who it is for; - how I can browse projects, roles, orders, and performers; - what an AI agent can do through the Workix MCP and API; - which parts run locally and how credentials are kept safe. 4. Look at my current project and help me choose and complete one useful next step: - connect Workix MCP to my agent; - search for relevant work or performers; - publish or update a project, role, or performer profile; - deploy the Workix storefront on my own domain; - contribute an improvement to Workix. Use WORKIX_API=https://workix.co for the central hub. Do not upload freelance-platform passwords or tokens to the hub. Adapt the instructions to my operating system, tools, and project.
This repository contains the open clients and integrations for Workix. They use the central hub API athttps://workix.co, so a local copy can display the shared catalog without maintaining a separate catalog.
- views/contains the storefront pages.
- assets/contains the browser application, styles, translations, PWA files, and public API documents.
- mcp/contains the TypeScript MCP server, Workix tools, and adapters for supported job platforms.
- docker/contains a small nginx image for serving the storefront.
- docs/contains public guides for agents and self-hosting.
- Storefront— a web interface for browsing the Workix catalog. You can use it atworkix.coor host the UI on your own domain.
- MCP server— tools that let an AI agent search Workix, manage your listings and profile, prepare proposals, and work with supported external sources.
Catalog data is served by the central Workix API. Production secrets are not required to run the storefront or connect the MCP client.
WithWORKIX_API=https://workix.co, an agent can search projects, roles, orders, and performers. With aWORKIX_AGENT_KEY, it can also create or update listings and manage a performer profile.
Recommended:install MCP from this repository’s source (freshest tools and adapters). npm/npxis optional and may lag behind git.
RequiresNode 22.5 or newer: the local store is SQLite through Node's built-innode:sqlite, so nothing has to compile at install time.
git clone https://github.com/facetoplace/Workix.git cd Workix/mcp npm install npm run build
Example Cursor MCP configuration (from source):
{ "mcpServers": { "workix": { "command": "node", "args": ["FULL/PATH/TO/Workix/mcp/dist/index.js"], "env": { "WORKIX_API": "https://workix.co", "WORKIX_AGENT_KEY": "wix_…" } } } }
Optional shortcut:npx -y @workix/mcp· npm@workix/mcp· Official Registryco.workix/mcp· install UI:workix.co/agent
External platform credentials belong only in the local MCP environment. Do not send Upwork, Kwork, or other platform passwords and tokens to the Workix hub.
Seemcp/README.mdfor installation, available tools, and source-specific settings.
Projects and communities can serve the Workix UI from a domain such aswork.example.com. The mirror still reads the shared catalog fromhttps://workix.co.
-
Deployviews/andassets/, or use the image indocker/.
<meta name="workix-api" content="https://workix.co" />
You can also setAPI_BASEorWORKIX_APItohttps://workix.co.
Configure your DNS and hosting for the chosen domain.
Listings associated with that domain can be featured for visitors to the mirror. Seework.facetoplace.appfor a live example and[docs/self-host.mdfor details.
Workix MCP is also a single interface for working with external freelance marketplaces and job boards. An agent can search several sources in one digest, open a specific listing, draft a proposal, and either submit it through an available API or prepare a browser checklist for you.
These integrations run locally. API tokens, platform logins, and browser sessions stay on your machine and are not sent to the Workix hub. Proposal submission always requires explicit human confirmation.
The score describes how much of theintended Workix workflowis ready today, not how much of the platform itself is covered:
- 5/5— search and submission work through a supported API.
- 4/5— reliable search; submission or authentication still has a fallback or limitation.
- 3/5— useful integration, but credentials, proxies, or an unofficial interface affect reliability.
- 2/5— browser-assisted watch source rather than an automated feed.
- 1/5— link/checklist only; deep automation is intentionally out of scope.
TheAutomation policycolumn is deliberately conservative. Platform terms and API permissions can change, so users must also follow the current rules of each source and their own account.
- Stabilize Freelancer.com and complete the Upwork OAuth/apply workflow.
- Improve FL.ru, Freelance.ru, Weblancer, and Kwork reliability.
- Add better filters for Remote OK and HH.ru, and grow the employer ATS company list.
- Keep closed and ToS-sensitive platforms browser-assisted instead of building fragile scrapers.
…
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
