Web3 Jobs MCP Server

1# Web3 Jobs MCP Server
2 
3An MCP server that provides AI agents with real-time access to curated Web3 jobs from [web3.career](https://web3.career/), enabling intelligent job discovery and career insights.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/web3-jobs-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9 
10## Features
11 
12- **Job Query Tool**: Filter Web3 jobs by:
13  - Remote status (`remote=True` for remote-only jobs)
14  - Country (e.g., `"United States"`, case-insensitive)
15  - Job tag (e.g., `"react"`, `"blockchain"`, case-insensitive)
16  - Limit (1–100 jobs, default 50)
17- **Markdown Output**: Returns job listings as a formatted Markdown list with:
18  - Job ID, Title, Company, Location, Remote status
19  - Published At (from `date_epoch`, formatted as `YYYY-MM-DD`)
20  - Apply URL (clickable link to web3.career)
21  - Description (plain text, truncated to 100 characters)
22- **Search Prompt**: Generates user-friendly job search queries based on role and optional location.
23 
24## Prerequisites
25 
26- Python 3.10+
27- A web3.career API token (request at [web3.career/web3-jobs-api](https://web3.career/web3-jobs-api))
28- [uv](https://github.com/astral-sh/uv) for dependency management (recommended)
29 
30## Installation
31 
321. **Clone the Repository**:
33   ```bash
34   git clone https://github.com/kukapay/web3-jobs-mcp.git
35   cd web3-jobs-mcp
36   ```
37 
382. **Install Dependencies**:
39   Using `uv`:
40   ```bash
41   uv sync
42   ```
43   Alternatively, with `pip`:
44   ```bash
45   pip install mcp[cli] python-dotenv
46   ```
47   
483. **Installing to Claude Desktop**:
49 
50    Install the server as a Claude Desktop application:
51    ```bash
52    uv run mcp install cli.py --name "Web3 Jobs"
53    ```
54 
55    Configuration file as a reference:
56 
57    ```json
58    {
59       "mcpServers": {
60           "Web3 Jobs": {
61               "command": "uv",
62               "args": [ "--directory", "/path/to/web3-jobs-mcp", "run", "main.py" ],
63               "env": { "WEB3_CAREER_API_TOKEN", "your-api-token" },  
64           }
65       }
66    }
67    ```
68    Replace `/path/to/web3-jobs-mcp` with your actual installation path, and `your-api-token` with your web3.career API token.
69    
70## Usage
71 
72### Running the Server
73 
74Start the server in development mode with the MCP Inspector:
75```bash
76uv run mcp dev main.py
77```
78This opens a web interface for testing tools and prompts.
79 
80Alternatively, run directly:
81```bash
82uv run main.py
83```
84 
85### Using the `query_jobs` Tool
86 
87In the MCP Inspector or a compatible client (e.g., Claude Desktop), call the `query_jobs` tool:
88 
89- **Example 1**: Get 5 remote blockchain jobs:
90  ```bash
91  query_jobs(remote=True, tag="blockchain", limit=5)
92  ```
93 
94- **Example 2**: Get 10 jobs in the United States:
95  ```bash
96  query_jobs(country="United States", limit=10)
97  ```
98 
99**Sample Output**:
100```markdown
101# Web3 Job Listings
102 
103- **Job ID**: 103945
104  - **Title**: Applied Crypto-Economics & Mechanism Design
105  - **Company**: Subzero Labs
106  - **Location**: Remote Remote Remote
107  - **Remote**: Yes
108  - **Published At**: 2025-06-01
109  - **Apply URL**: [Apply](https://web3.career/r/1QTOzATM__UVWHaa)
110  - **Description**: About Rialo We are a pioneering force in the decentralized finance (DeFi) space...
111 
112- **Job ID**: 103944
113  - **Title**: Blockchain Engineer
114  - **Company**: CryptoTech
115  - **Location**: Remote
116  - **Remote**: Yes
117  - **Published At**: 2025-05-31
118  - **Description**: Join our team to build cutting-edge blockchain solutions for global clients...
119  - **Apply URL**: [Apply](https://web3.career/r/2XYZabc123)
120 
121*Source: web3.career*
122```
123 
124### Using the `search_jobs_prompt`
125 
126Generate a search prompt for a specific role and location:
127```bash
128/search_jobs_prompt role="blockchain developer" location="remote"
129```
130This returns a prompt like:
131```
132Find Web3 jobs for a blockchain developer role in remote. Provide job titles, companies, locations, and application links from web3.career.
133```
134 
135## License
136 
137This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
138 
139