cv.json — open CV data

io.github.freecvorgPublished by GitHub account freecvorgv1.1.1Updated Oct 24, 2026

Search people open to work and fetch their machine-readable cv.json, from any AI assistant.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryBusiness & Commerce

Overview

AI-generated overview

Searches FreeCV's live index of people open to work and fetches their machine-readable cv.json, plus validates and explains the cv.json schema.

What you can do
Search FreeCV's live index of people open to work by skills, role, location and recruiter facets such as work type, employment type, visa sponsorship, languages and minimum experience, returning lean candidate cards. Fetch a person's full machine-readable cv.json by FreeCV slug or livelink.cv URL, returning structured basics, work, education, skills, languages, availability, ATS and verification data. Validate a cv.json document, given directly or fetched by slug or URL, against the official schema and get validity and errors. Retrieve the official cv.json JSON Schema to understand or generate compliant documents.
When to use it
Useful for recruiting and sourcing workflows where an assistant should find candidates open to work and pull their structured CVs, or for anyone producing or checking cv.json documents against the official format.
Requirements
Runs as a remote endpoint at freecv.org or as a local npm package (cvjson-mcp) over stdio. No authentication, environment variables or headers are declared. Network access is needed to reach the live index.
Before you install
Search returns personal data about real people, including names, roles, locations and skills; handle it according to privacy and recruiting rules. Fetching a CV by slug or URL retrieves an individual's full profile, so only request what you need.

Installation

In SourceWeft

  1. Open cv.json — open CV data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.freecvorg%2Fcvjson/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cv-json-open-cv-data": {
      "type": "http",
      "url": "https://freecv.org/api/mcp"
    }
  }
}

README

This repository has no README.

Tools

4

search_open_to_work

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).

ParameterssortlimitquerytitleoffsetskillslocationworkTypelanguagesminYearsExpsponsorshipemploymentType

fetch_cv

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.

Parametersurlslug

validate_cv

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[] }.

Parametersurlslugcvjson

get_cvjson_schema

Return the official cv.json JSON Schema (the format spec) — use it to understand or generate a compliant cv.json.

Takes no parameters.

Version history

1
  1. v1.1.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts