jobswithgpt

What is mcp?

mcp is a job search Multi-tool Co-Pilot (MCP) that indexes over 500,000 public job listings and continuously refreshes them. It allows users to find job opportunities using natural language queries.

How to use mcp?

As a Claude Desktop MCP Client:

1. Install uv with Python version > 3.12.
2. Install the mcp server by running: uv run mcp install server.py
3. Once installed, you can query it with examples like: "Find ML jobs in SF"

With OpenAI: OpenAI can directly use the hosted MCP server at https://jobswithgpt.com/mcp/. You can integrate it into your OpenAI client as shown in the example:

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)

Key Features of mcp

• Extensive Job Indexing: Indexes over 500,000 public job listings.
• Continuous Refresh: Job listings are continuously updated.
• Natural Language Search: Allows users to find jobs using conversational queries.
• Multi-tool Co-Pilot (MCP): Designed to work as an MCP client for AI models like Claude and OpenAI.
• Easy Integration: Simple installation for Claude Desktop and direct API integration for OpenAI.

Use Cases of mcp

• Job Seekers: Individuals looking for job opportunities in specific fields or locations.
• AI Assistants/Chatbots: Integrating job search capabilities into AI-powered assistants.
• Developers: Building applications that require access to a comprehensive and up-to-date job database.

FAQ about mcp

• What kind of jobs does it index? It indexes public job listings.
• How often are the job listings refreshed? They are refreshed continuously.
• Can I use it with other AI models besides Claude and OpenAI? The documentation primarily focuses on Claude and OpenAI integration, but as an MCP, it might be adaptable to other platforms that support MCP clients.
• Is there a self-hosted option for the MCP server? Yes, you can install and run the mcp server locally as demonstrated for Claude Desktop integration.
• How accurate are the job listings? The accuracy depends on the source of the public job listings, which are continuously updated.

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

mcp % 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/)

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)

Example output

Here are some Python developer job opportunities in San Francisco:

1. Software Engineer - Backend, Product Engineering at Baton
   [Apply here](https://job-boards.greenhouse.io/baton/jobs/4011483007)

2. Senior Backend Engineer at Stellic
   [Apply here](https://job-boards.greenhouse.io/stellic/jobs/4705805007)

3. Software Engineer - Backend at Julius AI
   [Apply here](https://jobs.ashbyhq.com/julius/75f8ef44-4fa4-46fa-b416-c7b697078eca)
etc