Web3 Jobs

You deploy and run a specialized MCP server that gives AI agents quick access to real-time Web3 job listings from web3.career. It offers a job query tool with filtering, outputs listings in a readable Markdown format, and can generate user-friendly search prompts to tailor job searches by role and location.

How to use

Launch and interact with the Web3 Jobs MCP Server using an MCP client. You can run queries to fetch job listings, customize results with filters like remote status, country, and tags, and receive results in a clean Markdown format that includes job details and application links. You can also generate search prompts to create strong, role-specific search queries for Web3 job hunting.

How to install

Prerequisites you need before installation are Python 3.10 or newer and an API token for web3.career. A runtime tool named UV is recommended for dependency management and running MCP commands.

# Install the MCP client stack (Python + MCP tooling)
pip install mcp[cli] python-dotenv

# Optional: install dependencies for runtime tooling if you plan to build locally
uv sync

Additional setup notes

To enable live operation, you will need your web3.career API token. Store this token securely and provide it to the MCP server as shown in the configuration example.

Configuration and runtime commands

You can configure the server to run locally via UV and reference a path to your MCP project. The following configuration snippet demonstrates how to register the Web3 Jobs MCP server locally with UV. Ensure you replace the placeholder path with your actual installation path and provide your real API token.

{
  "mcpServers": {
    "Web3 Jobs": {
      "command": "uv",
      "args": [ "--directory", "/path/to/web3-jobs-mcp", "run", "main.py" ],
      "env": { "WEB3_CAREER_API_TOKEN": "your-api-token" }
    }
  }
}

Usage patterns with the MCP Inspector

Run the development server to test tools and prompts in an MCP Inspector-like interface. Start the server in development mode to explore available tools and their prompts.

Using the query and prompt tools

• Use the query tool to fetch Web3 job listings with filters such as remote, country, tag, and a limit of 1–100 results. Results appear as a Markdown list with job details and a clickable Apply URL.

• Use the search prompt tool to generate a user-friendly search query based on a role and optional location. This helps you construct effective searches for Web3 jobs.

Notes on output and formatting

The job listings are formatted in Markdown, including Job ID, Title, Company, Location, Remote status, Published At (YYYY-MM-DD), Apply URL, and a concise Description excerpt (up to 100 characters). This makes it easy to copy, share, or act on the results.

Security and credentials

Keep your API token secure and do not expose it in public channels. Use environment variables or secret management to inject the token at runtime.

Troubleshooting

If you encounter connection issues, verify that UV is installed and available in your PATH, confirm the API token is correctly provided, and ensure the MCP server path in your configuration matches your installation directory.

Examples

# Example: 5 remote blockchain jobs
- Job ID: 103945
- Title: Applied Crypto-Economics & Mechanism Design
- Company: Subzero Labs
- Location: Remote
- Remote: Yes
- Published At: 2025-06-01
- Apply URL: https://web3.career/job/103945
- Description: About Rialo We are a pioneering force in the decentralized finance (DeFi) space...

Available tools

query_jobs

Fetch Web3 job listings from web3.career with filters for remote status, country, tag, and limit, returning results as a Markdown-formatted list.

search_jobs_prompt

Generate user-friendly search prompts for a given role and optional location to guide job searches.