`greenhouse_get_candidate`

Pack: greenhouse · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

Get full candidate profile by ID. Returns resume, contact info, application history, interviews, and notes.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Greenhouse Harvest API key
`id`	number	yes	Candidate ID

Example call

Arguments

{
  "_apiKey": "your-greenhouse-api-key",
  "id": 12345
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('greenhouse_get_candidate', {
  "_apiKey": "your-greenhouse-api-key",
  "id": 12345
});

Response shape

Field	Type	Description
`id`	number	Candidate ID
`first_name`	string	Candidate first name
`last_name`	string	Candidate last name
`email`	string	Primary email address
`phone`	string	Phone number
`resume`	string	Resume text or URL
`applications`	array	List of applications
`interviews`	array	List of interviews
`notes`	array	Notes on candidate

Full JSON Schema

{
  "type": "object",
  "description": "Full candidate profile with resume, contact info, and history",
  "properties": {
    "id": {
      "type": "number",
      "description": "Candidate ID"
    },
    "first_name": {
      "type": "string",
      "description": "Candidate first name"
    },
    "last_name": {
      "type": "string",
      "description": "Candidate last name"
    },
    "email": {
      "type": "string",
      "description": "Primary email address"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "resume": {
      "type": "string",
      "description": "Resume text or URL"
    },
    "applications": {
      "type": "array",
      "description": "List of applications",
      "items": {
        "type": "object"
      }
    },
    "interviews": {
      "type": "array",
      "description": "List of interviews",
      "items": {
        "type": "object"
      }
    },
    "notes": {
      "type": "array",
      "description": "Notes on candidate",
      "items": {
        "type": "object"
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the greenhouse pack

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

See Getting Started for client-specific install steps.

greenhouse_get_candidate