cv.json — open CV data is an MCP server published by io.github.freecvorg, hosted at freecv.org. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including search_open_to_work, fetch_cv, validate_cv, get_cvjson_schema.
Search people open to work and fetch their machine-readable cv.json, from any AI assistant.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search FreeCV's LIVE index of real people who are open to work — by skills, role/title, location, and recruiter facets (work type, employment type, visa sponsorship, languages, minimum experience). Returns lean candidate cards (name, current role @ company, location, top skills, languages, and the full availability preferences) plus each person's cv.json URL and portfolio URL — enough to shortlist WITHOUT a fetch_cv per candidate. Call fetch_cv on a result to read the complete structured CV. Only already-public profiles are indexed; contact details are never returned (reach candidates via their portfolio).
| Parameter | Type | Description |
|---|---|---|
| sort | string | Ranking: best match (default), most recently updated, or most experienced. |
| limit | integer | Max results per page (default 20). |
| query | string | Free-text query matched across name, title, skills and experience (e.g. "senior react developer"). |
| title | string | Target role/title, e.g. "Product Designer". |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| offset | integer | Result offset for paging through a large shortlist (default 0). Use with `total` in the response. |
| skills | array | Specific skills to match, e.g. ["React","TypeScript"]. |
| location | string | Country-aware location filter, e.g. "UK" (matches London/Manchester), "Berlin", "Gaza". |
| workType | array | Only candidates who OFFER one of these work arrangements. |
| languages | array | Languages the candidate must speak, e.g. ["German","Arabic"]. |
| minYearsExp | integer | Minimum years of experience. |
| sponsorship | boolean | Filter by visa-sponsorship need: false = does NOT need sponsorship, true = needs it. Candidates who never answered are excluded from this filter. |
| employmentType | array | Only candidates open to one of these employment types. |
{
"name": "search_open_to_work",
"description": "Search FreeCV's LIVE index of real people who are open to work — by skills, role/title, location, and recruiter facets (work type, employment type, visa sponsorship, languages, minimum experience). Returns lean candidate cards (name, current role @ company, location, top skills, languages, and the full availability preferences) plus each person's cv.json URL and portfolio URL — enough to shortlist WITHOUT a fetch_cv per candidate. Call fetch_cv on a result to read the complete structured CV. Only already-public profiles are indexed; contact details are never returned (reach candidates via their portfolio).",
"inputSchema": {
"type": "object",
"properties": {
"sort": {
"enum": [
"best",
"fresh",
"exp"
],
"type": "string",
"description": "Ranking: best match (default), most recently updated, or most experienced."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results per page (default 20)."
},
"query": {
"type": "string",
"description": "Free-text query matched across name, title, skills and experience (e.g. \"senior react developer\")."
},
"title": {
"type": "string",
"description": "Target role/title, e.g. \"Product Designer\"."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Result offset for paging through a large shortlist (default 0). Use with `total` in the response."
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific skills to match, e.g. [\"React\",\"TypeScript\"]."
},
"location": {
"type": "string",
"description": "Country-aware location filter, e.g. \"UK\" (matches London/Manchester), \"Berlin\", \"Gaza\"."
},
"workType": {
"type": "array",
"items": {
"enum": [
"remote",
"hybrid",
"onsite"
],
"type": "string"
},
"description": "Only candidates who OFFER one of these work arrangements."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages the candidate must speak, e.g. [\"German\",\"Arabic\"]."
},
"minYearsExp": {
"type": "integer",
"minimum": 1,
"description": "Minimum years of experience."
},
"sponsorship": {
"type": "boolean",
"description": "Filter by visa-sponsorship need: false = does NOT need sponsorship, true = needs it. Candidates who never answered are excluded from this filter."
},
"employmentType": {
"type": "array",
"items": {
"enum": [
"full-time",
"part-time",
"contract",
"internship",
"temporary",
"volunteer"
],
"type": "string"
},
"description": "Only candidates open to one of these employment types."
}
}
}
}Fetch a person's cv.json — their full machine-readable CV — by FreeCV slug or livelink.cv URL. Returns structured JSON: basics, work, education, skills, languages, availability, ats, verification, i18n.
| Parameter | Type | Description |
|---|---|---|
| url | string | Full cv.json URL (alternative to slug). |
| slug | string | The slug, e.g. "ashley" (from livelink.cv/ashley). |
{
"name": "fetch_cv",
"description": "Fetch a person's cv.json — their full machine-readable CV — by FreeCV slug or livelink.cv URL. Returns structured JSON: basics, work, education, skills, languages, availability, ats, verification, i18n.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Full cv.json URL (alternative to slug)."
},
"slug": {
"type": "string",
"description": "The slug, e.g. \"ashley\" (from livelink.cv/ashley)."
}
}
}
}Validate a cv.json document against the official cv.json schema. Provide the document (cvjson, object or JSON string) OR a slug/url to fetch and validate. Returns { valid, errors[] }.
| Parameter | Type | Description |
|---|---|---|
| url | string | Fetch and validate this cv.json URL. |
| slug | string | Fetch and validate this slug's live cv.json. |
| cvjson | any | The cv.json document to validate (object or JSON string). |
{
"name": "validate_cv",
"description": "Validate a cv.json document against the official cv.json schema. Provide the document (cvjson, object or JSON string) OR a slug/url to fetch and validate. Returns { valid, errors[] }.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Fetch and validate this cv.json URL."
},
"slug": {
"type": "string",
"description": "Fetch and validate this slug's live cv.json."
},
"cvjson": {
"description": "The cv.json document to validate (object or JSON string)."
}
}
}
}Return the official cv.json JSON Schema (the format spec) — use it to understand or generate a compliant cv.json.
No parameters.
{
"name": "get_cvjson_schema",
"description": "Return the official cv.json JSON Schema (the format spec) — use it to understand or generate a compliant cv.json.",
"inputSchema": {
"type": "object",
"properties": {}
}
}cv.json is the open, machine-readable CV format from FreeCV (cvjson.com). Use search_open_to_work to find real people who are open to work by skill/role/location, then fetch_cv on a result to read their full structured CV. validate_cv checks any document against the official schema (get_cvjson_schema returns that schema).
Names, descriptions and schemas were written by the server and are shown as data.