kukapay/web3-jobs-mcp

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**:
2. **Install Dependencies**:
Using uv:
Alternatively, with pip:
3. **Installing to Claude Desktop**:
Install the server as a Claude Desktop application:
Configuration file as a reference:
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:
This opens a web interface for testing tools and prompts.
Alternatively, run directly:
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:
- **Example 2**: Get 10 jobs in the United States:
**Sample Output**:
Using the search_jobs_prompt
Generate a search prompt for a specific role and location:
This returns a prompt like:
License
This project is licensed under the MIT License. See the LICENSE file for details.