JO

jobswithgpt

Created 5 months ago

MCP server for job searching using Claude Desktop and OpenAI.

development documentation public

What is jobswithgpt?

Job search MCP using jobswithgpt which indexes 500K+ public job listings and refreshed continously.

Documentation

Configuring Claude Desktop as an MCP Client

  1. Install uv with python version > 3.12 for your OS.
  2. Install the mcp server - easy! uv run mcp install server.py
Using CPython 3.12.3
Creating virtual environment at: .venv
Installed 27 packages in 23ms
[06/02/25 11:25:38] INFO Added server 'jobswithgpt_search' to claude.py:143
Claude config
INFO Successfully installed cli.py:504 jobswithgpt_search in Claude app
mcp % ```

``` Example query: "Find ML jobs in SF" ```

### OpenAI instructions
OpenAI can directly use the server hosted MCP server (https://jobswithgpt.com/mcp/)
```python
import openai
client = openai.OpenAI()
resp = client.responses.create(
 model="gpt-4.1-mini",
 tools=[
 {
 "type": "mcp",
 "server_label": "jobswithgpt",
 "server_url": "https://jobswithgpt.com/mcp/",
 "require_approval": {
 "never": {
 "tool_names": ["search_jobs"]
 }
 }
 },
 ],
 input="find jobs for python devs in sf"
)
print(resp.output_text)

Server Config

{
  "mcpServers": {
    "jobswithgpt-server": {
      "command": "npx",
      "args": [
        "jobswithgpt"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: Yes
Global: Yes
Official: Yes

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: jobswithgpt
Category: community
Tags:
development documentation public