Web3 Jobs MCP Server

@kukapay

About Web3 Jobs MCP Server

An MCP server that provides AI agents with real-time access to curated Web3 jobs.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "web3-jobs-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Web3 Jobs MCP Server?

Web3 Jobs MCP Server is an MCP (Model Context Protocol) server that gives AI agents real-time access to curated Web3 jobs from web3.career, enabling intelligent job discovery and career insights. It is designed for developers and AI assistants who need up‑to‑date Web3 job listings.

How to use Web3 Jobs MCP Server?

Install dependencies with uv sync (recommended) or pip install mcp[cli] python-dotenv. Obtain a web3.career API token at web3.career/web3-jobs-api. Configure the server in Claude Desktop using the provided JSON snippet, setting the WEB3_CAREER_API_TOKEN environment variable. Start the server with uv run mcp dev main.py (for testing via MCP Inspector) or uv run main.py. Use the query_jobs tool to filter jobs by remote, country, tag, and limit, and the search_jobs_prompt for generating search queries.

Key features of Web3 Jobs MCP Server

Query Web3 jobs with filters: remote status, country, tag, and limit.
Returns formatted Markdown list with job ID, title, company, location, and more.
Includes clickable apply URLs and truncated descriptions (100 characters).
Provides a search prompt generator for role and location.

Use cases of Web3 Jobs MCP Server

AI‑powered job boards that show live Web3 opportunities.
Automated career advice bots that deliver filtered job recommendations.
Developer tools that integrate Web3 job search into assistant workflows.
Recruitment analysis by aggregating listings with specific tags or locations.

FAQ from Web3 Jobs MCP Server

What prerequisites are needed to run Web3 Jobs MCP Server?

Python 3.10+ and a web3.career API token are required. The uv package manager is recommended for dependency management.

How do I get a web3.career API token?

Request one at web3.career/web3-jobs-api. The token must be set in the environment variable WEB3_CAREER_API_TOKEN.

How do I install Web3 Jobs MCP Server on Claude Desktop?

Clone the repo, install dependencies with uv sync, then run uv run mcp install cli.py --name "Web3 Jobs". Alternatively, manually add the server configuration to Claude Desktop’s mcpServers JSON.

What does the `query_jobs` tool do?

It fetches Web3 jobs from web3.career with optional filters: remote (boolean), country (string, case‑insensitive), tag (string, case‑insensitive), and limit (integer, 1–100, default 50). Results are returned as structured Markdown.

Is there a prompt available for job search?

Yes, the search_jobs_prompt generates a natural language prompt based on a given role and location, e.g., /search_jobs_prompt role="blockchain developer" location="remote".

Frequently asked questions

What prerequisites are needed to run Web3 Jobs MCP Server?

Python 3.10+ and a web3.career API token are required. The [uv](https://github.com/astral-sh/uv) package manager is recommended for dependency management.

How do I get a web3.career API token?

Request one at [web3.career/web3-jobs-api](https://web3.career/web3-jobs-api). The token must be set in the environment variable `WEB3_CAREER_API_TOKEN`.

How do I install Web3 Jobs MCP Server on Claude Desktop?

Clone the repo, install dependencies with `uv sync`, then run `uv run mcp install cli.py --name "Web3 Jobs"`. Alternatively, manually add the server configuration to Claude Desktop’s `mcpServers` JSON.

What does the `query_jobs` tool do?

It fetches Web3 jobs from web3.career with optional filters: `remote` (boolean), `country` (string, case‑insensitive), `tag` (string, case‑insensitive), and `limit` (integer, 1–100, default 50). Results are returned as structured Markdown.

Is there a prompt available for job search?

Yes, the `search_jobs_prompt` generates a natural language prompt based on a given role and location, e.g., `/search_jobs_prompt role="blockchain developer" location="remote"`.