Web3 Career MCP server for AI agents

The Web3 Jobs MCP Server provides AI agents with real-time access to curated Web3 jobs from web3.career, enabling intelligent job discovery and career insights for those looking to work in the blockchain and cryptocurrency space.

Features

Job Query Tool: Filter Web3 jobs by remote status, country, job tag, and number of results
Markdown Output: Receive job listings in a well-formatted Markdown list
Search Prompt: Generate user-friendly job search queries based on role and location

Prerequisites

Python 3.10+
A web3.career API token (request at https://web3.career/web3-jobs-api)
uv for dependency management (recommended)

Installation

Clone the Repository

git clone https://github.com/kukapay/web3-jobs-mcp.git
cd web3-jobs-mcp

Install Dependencies

Using uv:

uv sync

Alternatively, with pip:

pip install mcp[cli] python-dotenv

Installing to Claude Desktop

Install the server as a Claude Desktop application:

uv run mcp install cli.py --name "Web3 Jobs"

Configuration file example:

{
   "mcpServers": {
       "Web3 Jobs": {
           "command": "uv",
           "args": [ "--directory", "/path/to/web3-jobs-mcp", "run", "main.py" ],
           "env": { "WEB3_CAREER_API_TOKEN", "your-api-token" },  
       }
   }
}

Make sure to replace /path/to/web3-jobs-mcp with your actual installation path, and your-api-token with your web3.career API token.

Usage

Running the Server

Start the server in development mode with the MCP Inspector:

uv run mcp dev main.py

This opens a web interface for testing tools and prompts. Alternatively, run directly:

uv run main.py

Using the Query Jobs Tool

In the MCP Inspector or a compatible client (e.g., Claude Desktop), call the query_jobs tool:

Example 1: Get 5 remote blockchain jobs:

query_jobs(remote=True, tag="blockchain", limit=5)

Example 2: Get 10 jobs in the United States:

query_jobs(country="United States", limit=10)

Sample Output

# Web3 Job Listings

- **Job ID**: 103945
  - **Title**: Applied Crypto-Economics & Mechanism Design
  - **Company**: Subzero Labs
  - **Location**: Remote Remote Remote
  - **Remote**: Yes
  - **Published At**: 2025-06-01
  - **Apply URL**: [Apply](https://web3.career/r/1QTOzATM__UVWHaa)
  - **Description**: About Rialo We are a pioneering force in the decentralized finance (DeFi) space...

- **Job ID**: 103944
  - **Title**: Blockchain Engineer
  - **Company**: CryptoTech
  - **Location**: Remote
  - **Remote**: Yes
  - **Published At**: 2025-05-31
  - **Description**: Join our team to build cutting-edge blockchain solutions for global clients...
  - **Apply URL**: [Apply](https://web3.career/r/2XYZabc123)

*Source: web3.career*

Using the Search Jobs Prompt

Generate a search prompt for a specific role and location:

/search_jobs_prompt role="blockchain developer" location="remote"

This returns a prompt like:

Find Web3 jobs for a blockchain developer role in remote. Provide job titles, companies, locations, and application links from web3.career.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "Web3-Jobs" '{"command":"uv","args":["--directory","/path/to/web3-jobs-mcp","run","main.py"],"env":{"WEB3_CAREER_API_TOKEN":"your-api-token"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "Web3 Jobs": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/web3-jobs-mcp",
                "run",
                "main.py"
            ],
            "env": {
                "WEB3_CAREER_API_TOKEN": "your-api-token"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "Web3 Jobs": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/web3-jobs-mcp",
                "run",
                "main.py"
            ],
            "env": {
                "WEB3_CAREER_API_TOKEN": "your-api-token"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect