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)
- Remote status (
- 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:
- Install Dependencies:
Using
uv
:Alternatively, withpip
: - 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, 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:
- 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.
Related MCP Servers
- PythonMIT License
- PythonMIT License
- TypeScriptMIT License
- TypeScriptMozilla Public License 2.0