Provides repository access for installation and setup of the Web3 Jobs MCP server via Git clone from the kukapay/web3-jobs-mcp repository.
Formats job listings as structured Markdown content with details including job ID, title, company, location, remote status, publication date, and application links.
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 asYYYY-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
Clone the Repository:
git clone https://github.com/kukapay/web3-jobs-mcp.git cd web3-jobs-mcpInstall Dependencies: Using
uv
:uv syncAlternatively, with
pip
:pip install mcp[cli] python-dotenvInstalling 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, andyour-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:
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:
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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
web3-jobs-mcp
Related MCP Servers
- MIT License
- MIT License