Web3 Career Server

This is a Model Context Protocol (MCP) server that wraps the Web3.career API. It allows AI agents to search for the latest Web3 jobs with various filters.

Features

• Query Jobs: Fetch the latest job listings.
• Filters:
  • Remote only
  • Limit number of results
  • Filter by country (e.g., 'united-states')
  • Filter by tag/skill (e.g., 'react', 'rust', 'marketing')
  • Toggle job descriptions

Usage Tips & Limitations

• Tags: The tag filter expects a single keyword or slug.

  • ✅ Good: "marketing", "react", "solidity", "design"
  • ❌ Bad: "marketing jobs", "senior react developer", "web3 marketing"
  • If you want to search for "marketing jobs", just use tag: "marketing".

• Country: Use country slugs (lowercase, hyphenated).

  • ✅ Good: "united-states", "united-kingdom", "germany"
  • ❌ Bad: "USA", "United Kingdom"

Available Tags

Here is a list of common tags you can use to filter jobs. Remember to use the exact slug/keyword.

Roles & Levels

analyst, community manager, cto, customer support, data science, design, developer relations, devops, economy designer, entry level, executive, finance, founder, hr, intern, legal, marketing, moderator, operations, product manager, project manager, research, sales

Engineering & Tech

backend, cryptography, front end, full stack, gaming, mobile, smart contract, security

Languages & Frameworks

golang, java, javascript, node, python, react, ruby, rust, solidity, typescript, web3js, web3 py

Blockchain & Ecosystems

bitcoin, blockchain, cosmos, ethereum, evm, layer 2, polkadot, polygon, solana, tezos

Web3 Specific

ai, crypto, dao, defi, discord, erc, erc 20, ganache, hardhat, metaverse, nft, non tech, open source, openzeppelin, pay in crypto, refi, truffle, zero knowledge

Setup

Prerequisites

• Node.js (v18 or higher)
• npm

Installation

1. Clone the repository (if applicable) or download the source.
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Configuration

Claude Desktop / Cursor

Add the following configuration to your MCP settings file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json on macOS).

{
  "mcpServers": {
    "web3-career": {
      "command": "node",
      "args": ["/path/to/web3-career-mcp/dist/index.js"],
      "env": {
        "WEB3_CAREER_TOKEN": "your-api-token-here"
      }
    }
  }
}

Note: The WEB3_CAREER_TOKEN environment variable is required. You can obtain an API token from web3.career. Do not commit your token to version control.

Usage

The server exposes a single tool: get_web3_jobs.

Tool Arguments

• remote (boolean): Show only remote jobs.
• limit (number): Number of jobs to return (default 50, max 100).
• country (string): Filter by country slug (e.g., united-states, france).
• tag (string): Filter by tag (e.g., react, solidity).
• show_description (boolean): Include job description in the response (default true).

Development

To build the project in watch mode:

npx tsc --watch