Mcp

What is Mcp about?

Mcp provides a simple MCP server implementation that exposes job‑search functionality. The server can be called directly by AI models (e.g., Claude Desktop, OpenAI's GPT‑4.1‑mini) to retrieve relevant job listings based on natural‑language queries.

How to use Mcp?

1. Install the server – use UV (Python package manager) with Python > 3.12:

   uv run mcp install server.py
   

2. Configure the client – add the server label (e.g., jobswithgpt) and URL (https://jobswithgpt.com/mcp/) in the tool definition for Claude or OpenAI.
3. Make a request – send a query such as find jobs for python devs in sf through the AI model’s tool call. The model receives formatted job results.

Key features of Mcp

• One‑line installation via UV.
• Seamless integration with Claude Desktop and OpenAI’s tool interface.
• Automatic approval for specific tool names (e.g., search_jobs).
• Returns ready‑to‑use markdown with job titles and application links.

Use cases of Mcp

• Career assistants: embed job‑search capabilities into virtual assistants.
• Recruitment bots: automate candidate sourcing based on location and skill.
• Developer tools: enhance IDE chat assistants with real‑time job data.
• Custom AI agents: allow any MCP‑compatible model to fetch employment listings.

FAQ from the Mcp

Q: Which Python version is required? A: Python 3.12 or newer.

Q: Do I need an API key? A: The public demo at jobswithgpt.com/mcp/ does not require one, but self‑hosted instances may.

Q: Can I add more job sources? A: Yes, extend server.py to query additional job boards and return results in the same format.

Q: Is there a Node.js installation method? A: The official guide uses UV for Python; a Node wrapper is not provided yet.

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