query_jobs
Search and filter Web3 job listings from web3.career by remote status, country, or specific skills to find relevant opportunities in the blockchain industry.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | ||
| limit | No | ||
| remote | No | ||
| tag | No |
Input Schema (JSON Schema)
{
"properties": {
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50,
"title": "Limit"
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Remote"
},
"tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tag"
}
},
"type": "object"
}