`ashby_get_candidate`

Pack: ashby · Endpoint: https://gateway.pipeworx.io/ashby/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ashby_get_candidate for the schema, then POST the same URL with its arguments for the data.

Get full candidate profile by ID. Returns contact info, resume, interview history, and current application status.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Ashby API key
`candidateId`	string	yes	Ashby candidate ID

Example call

Arguments

{
  "_apiKey": "your-ashby-api-key",
  "candidateId": "cand_12345"
}

curl

curl -X POST https://gateway.pipeworx.io/ashby/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ashby_get_candidate","arguments":{"_apiKey":"your-ashby-api-key","candidateId":"cand_12345"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ashby_get_candidate', {
  "_apiKey": "your-ashby-api-key",
  "candidateId": "cand_12345"
});

Response shape

Field	Type	Description
`id`	string	Candidate ID
`name`	string	Candidate full name
`email`	string	Candidate email address
`resume`	string	Candidate resume content or URL
`applications`	array	List of applications from this candidate

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Candidate ID"
    },
    "name": {
      "type": "string",
      "description": "Candidate full name"
    },
    "email": {
      "type": "string",
      "description": "Candidate email address"
    },
    "resume": {
      "type": "string",
      "description": "Candidate resume content or URL"
    },
    "applications": {
      "type": "array",
      "description": "List of applications from this candidate",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Application ID"
          },
          "jobId": {
            "type": "string",
            "description": "Job ID applied for"
          },
          "stage": {
            "type": "string",
            "description": "Current application stage"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ashby": {
      "url": "https://gateway.pipeworx.io/ashby/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ashby_get_candidate