English Français العربية

io.github.Enigma-52/workway

Official registry Search and web

Search 490k+ live jobs from company ATS boards, save roles, follow companies, manage talent profile.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http workway 'https://www.workway.dev/api/mcp' --header 'Authorization: <Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "workway": {
            "type": "http",
            "url": "https://www.workway.dev/api/mcp",
            "headers": {
                "Authorization": "<Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. WorkWay Backend
  2. Stack
  3. Structure
  4. Setup
  5. API
  6. Health
  7. Ingestion
  8. Production

WorkWay Backend

API service powering WorkWay — company/job discovery, filters, sitemaps, and Greenhouse/Ashby/YC ingestion.

Stack

  • Node.js (ES modules) + Express 5
  • PostgreSQL (pg)

Structure

  • src/server.js — app bootstrap, DB init, route mount, graceful shutdown
  • src/config.js — environment/config mapping
  • src/routes/ — API route handlers
  • src/services/ — business logic
  • src/dao/ — SQL queries and DAO abstractions
  • src/utils/ — logger, constants, parsing/classification helpers
  • src/data/greenhouseCompanies.js — seed list of Greenhouse namespaces
  • docs/DETAILED_DOCS.md — detailed architecture and endpoint reference

Setup

npm install

Create .env in repo root:

APP_ENV=dev
POSTGRES_DB_HOST=localhost
POSTGRES_DB_PORT=5432
POSTGRES_DB_USER=postgres
POSTGRES_DB_PASSWORD=root
POSTGRES_DB_DATABASE=eqhqdb
POSTGRES_DB_MAX_CONNECTIONS=20
PORT=3000

Run:

npm run dev   # or: npm start

Defaults to http://localhost:3000.

API

Base path: /api

  • /api/company, /api/job, /api/feed, /api/filter, /api/cron
  • /api/sitemap.xml, /api/sitemaps/*
  • GET /api/job/list — paginated job listing with search/filters, returns jobs, meta, applied_filters, facets
  • GET /api/job/filters — facet counts for the filter UI

Full request/response reference: docs/DETAILED_DOCS.md

Health

  • GET /health — uptime + timestamp
  • GET / — server-running check

Ingestion

Cron-style HTTP endpoints load Greenhouse, Ashby, and YC companies, fetch their jobs, classify them (domain/level/employment type), and upsert into PostgreSQL.

Production

Serves workway.dev.

Frequently asked questions

What is io.github.Enigma-52/workway?

Search 490k+ live jobs from company ATS boards, save roles, follow companies, manage talent profile.

How do I install io.github.Enigma-52/workway?

It runs as a remote server. In Claude Code: claude mcp add --transport http workway 'https://www.workway.dev/api/mcp' --header 'Authorization: <Bearer <workway-api-key>. Generate a key at https://workway.dev/dashboard/seeker/api-keys>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Enigma-52/workway need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is io.github.Enigma-52/workway open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Enigma-52/workway?

It is published by Enigma-52. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.