# Workix

Wires an agent to the Workix catalog and a set of job boards: searching projects, roles, gigs and people, with results stored in a local database.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: facetoplace
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/facetoplace/Workix/tree/HEAD/mcp
- Updated: 2026-09-23
- HTML: https://affpapa.org/en/nevibecode/mcp/workix

## What it does

Workix is a local MCP server. It hands the agent tools over the Workix hub: search and create projects, roles, orders, participant profiles and mentors. A second group of tools reaches out to job boards for digests, search, proposal drafts and browser apply steps. Submitting the application stays with the human.

Collecting and searching are two steps. `workix_collect` pulls from all sources in parallel into a local store, then `workix_db_search` ranks the results offline: word-boundary matching, résumé and "for hire" entries dropped, cross-posts merged, a cap per advertiser, plus a check against your outreach log. Board modules are not needed at install time; the server fetches them on the first call and keeps a local copy.

Writing to the hub needs `WORKIX_AGENT_KEY`, and `WORKIX_API` sets the API address. Boards that read a logged-in browser profile sit behind opt-in flags and never submit anything. Without the key, search and reading still work while creating or editing cards does not — get the key sorted before the first run.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WORKIX_API`, `WORKIX_AGENT_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env WORKIX_API=<WORKIX_API> --env WORKIX_AGENT_KEY=<WORKIX_AGENT_KEY> --transport stdio mcp -- npx -y @workix/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env WORKIX_API=<WORKIX_API> --env WORKIX_AGENT_KEY=<WORKIX_AGENT_KEY> -- npx -y @workix/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@workix/mcp"
            ],
            "env": {
                "WORKIX_API": "<WORKIX_API>",
                "WORKIX_AGENT_KEY": "<WORKIX_AGENT_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@workix/mcp"
            ],
            "env": {
                "WORKIX_API": "<WORKIX_API>",
                "WORKIX_AGENT_KEY": "<WORKIX_AGENT_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WORKIX_API=<WORKIX_API> -e WORKIX_AGENT_KEY=<WORKIX_AGENT_KEY> mcp npx -y @workix/mcp
```
Replace <…> with your own values

## When to use it
- find gigs and vacancies for given skills across several boards at once
- keep collected listings in a local store and query them offline
- publish a project or role card to the Workix hub
- draft a proposal and prepare the browser steps to apply
- check the outreach log so you do not contact the same place twice

## Example prompts
- Collect python listings from every board and show the ones I have not applied to yet
- Search Workix for projects looking for react and frontend help
- Draft a proposal for this listing and give me the browser steps

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md