cvjson

endpoint

https://freecv.org/api/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is cvjson live?

Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.

Is cvjson free to use?

Yes — the hub reached it with no key and no payment.

What tools does cvjson have?

4 tools: validate_cv, fetch_cv, get_cvjson_schema, search_open_to_work.

Is cvjson safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_cvjson_schema reads open 6h ago

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

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• search_open_to_work reads open 6h ago

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

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687

  {
    "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."
      }
    }
  }

  arguments 87 lines copy
• validate_cv reads unknown never probed

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

  mcp-tool

  12345678910111213141516

  {
    "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)."
      }
    }
  }

  arguments 16 lines copy
• fetch_cv reads unknown 6h ago

  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.

  mcp-tool

  12345678910111213

  {
    "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)."
      }
    }
  }

  arguments 13 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.