web3-jobs-mcp

Query Web3 job listings from the web3.career API with optional filters.

Returns a Markdown-formatted list of jobs, including Job ID, Title, Company, Location,
Remote status, Published At date, Apply URL, and Description (always included).

Parameters:
    remote (Optional[bool]): Filter for remote jobs. Set to True for remote-only,
        False for non-remote, or None for no filter. Defaults to None.
    country (Optional[str]): Filter by country (e.g., "United States", "Canada").
        Case-insensitive, spaces are converted to hyphens (e.g., "united-states").
        Defaults to None (no country filter).
    tag (Optional[str]): Filter by job tag (e.g., "react", "blockchain").
        Case-insensitive. Defaults to None (no tag filter).
    limit (Optional[int]): Maximum number of jobs to return. Must be between 1 and 100.
        Defaults to 50. Raises ValueError if limit exceeds 100.
    ctx (Context): MCP context for logging and internal use. Automatically provided
        by the MCP framework. Defaults to None.

Returns:
    str: A Markdown string containing a list of job listings with the specified fields.

Notes:
    - Descriptions are always included (show_description is hardcoded to True),
      truncated to 100 characters, and have HTML tags removed.
    - Published At is derived from the 'date_epoch' field, formatted as YYYY-MM-DD.
    - Apply URL is included as a clickable Markdown link for each job.
    - Source is credited to web3.career per API terms.