Tools

Overview

The server exposes read tools for profile lookups and optional mutation tools for workflows that create data.

Read tools are marked readOnlyHint: true and idempotentHint: true.
Mutation tools are marked readOnlyHint: false and idempotentHint: false.
All tools keep destructiveHint: false and openWorldHint: true.

Every tool returns a text content item with pretty-printed JSON and the same data again in structuredContent.data.

Example tool result envelope

{
  "content": [
    {
      "type": "text",
      "text": "{ ...pretty-printed JSON... }"
    }
  ],
  "structuredContent": {
    "data": {}
  }
}

Read tools

`get_candidate`

Gets the top-level candidate profile. Input: none Related REST endpoint: GET /candidate

`list_experience`

Lists experience entries. You can optionally filter the response to current or past roles.

Input

{
  "current": true
}

current is optional.
Use true to request current roles only.
Use false to request past roles only.

Related REST endpoint: GET /experience

`get_experience`

Gets one experience entry by id.

Input

{
  "id": "exp_dat"
}

Related REST endpoint: GET /experience/{id}

`list_projects`

Lists project summaries. Input: none Related REST endpoint: GET /projects

`get_project`

Gets one project by id.

Input

{
  "id": "proj_007"
}

Related REST endpoint: GET /projects/{id}

`get_availability`

Gets the current availability status. Input: none Related REST endpoint: GET /availability

`get_resume`

Gets the resume as structured JSON or as a PDF link payload.

Input

{
  "format": "json"
}

format accepts json or pdf.
The default is json.

Related REST endpoint: GET /resume

Optional mutation tools

These tools only appear when the deployment enables them. They are not guaranteed to be present in every MCP client session.

`create_auth_token`

Creates a demo bearer token for the Candidate Profile API and triggers the API’s email notification flow.

Input

{
  "email": "recruiter@example.com"
}

Related REST endpoint: POST /auth/token

`create_contact`

Submits a contact request through the Candidate Profile API.

Input

{
  "name": "Hiring Manager",
  "email": "manager@example.com",
  "company": "Example Co",
  "message": "Let's talk about platform engineering roles."
}

Related REST endpoint: POST /contact

Overview

Resources

Interactions

Tools

Overview

Read tools

`get_candidate`

`list_experience`

`get_experience`

`list_projects`

`get_project`

`get_availability`

`get_resume`

Optional mutation tools

`create_auth_token`

`create_contact`

​Overview

​Read tools

​get_candidate

​list_experience

​get_experience

​list_projects

​get_project

​get_availability

​get_resume

​Optional mutation tools

​create_auth_token

​create_contact

Overview

Read tools

`get_candidate`

`list_experience`

`get_experience`

`list_projects`

`get_project`

`get_availability`

`get_resume`

Optional mutation tools

`create_auth_token`

`create_contact`