kukapay/web3-jobs-mcp

Web3 Jobs MCP Server

An MCP server that provides AI agents with real-time access to curated Web3 jobs from web3.career, enabling intelligent job discovery and career insights.

Features

• Job Query Tool: Filter Web3 jobs by:
  • Remote status (remote=True for remote-only jobs)
  • Country (e.g., "United States", case-insensitive)
  • Job tag (e.g., "react", "blockchain", case-insensitive)
  • Limit (1–100 jobs, default 50)
• Markdown Output: Returns job listings as a formatted Markdown list with:
  • Job ID, Title, Company, Location, Remote status
  • Published At (from date_epoch, formatted as YYYY-MM-DD)
  • Apply URL (clickable link to web3.career)
  • Description (plain text, truncated to 100 characters)
• Search Prompt: Generates user-friendly job search queries based on role and optional location.

Prerequisites

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

Installation

1. Clone the Repository:

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

2. Install Dependencies: Using uv:

   uv sync
   

   Alternatively, with pip:

   pip install mcp[cli] python-dotenv
   

3. Installing to Claude Desktop:

   Install the server as a Claude Desktop application:

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

   Configuration file as a reference:

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

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