ashby-mcp 1.0.0

package/README.md

@@ -0,0 +1,138 @@
+# ashby-mcp
+
+MCP server for [Ashby](https://www.ashbyhq.com/) ATS — designed for candidate evaluation workflows.
+
+This server exposes Ashby's recruiting data through the [Model Context Protocol](https://modelcontextprotocol.io/), letting AI agents review candidates, read application details, and write evaluation notes.
+
+## Setup
+
+### 1. Get an Ashby API Key
+
+1. Go to your Ashby admin settings → Integrations → API Keys
+2. Create a new API key with these permissions:
+   - `candidatesRead` — read candidate profiles, applications, notes, feedback
+   - `jobsRead` — read job listings and details
+   - `interviewsRead` — read interview stages and plans
+   - `candidatesWrite` — add notes, tags, and move application stages
+
+### 2. Install
+
+#### Option A: npx (recommended — no clone needed)
+
+Just add the config below and it works immediately.
+
+#### Option B: From source
+
+```bash
+git clone https://github.com/dewierwan/ashby-mcp.git && cd ashby-mcp
+npm install
+npm run build
+```
+
+### 3. Configure
+
+#### Claude Code
+
+Add to `~/.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "ashby": {
+      "command": "npx",
+      "args": ["-y", "ashby-mcp"],
+      "env": {
+        "ASHBY_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ashby": {
+      "command": "npx",
+      "args": ["-y", "ashby-mcp"],
+      "env": {
+        "ASHBY_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### Read tools
+
+| Tool | Description |
+|------|-------------|
+| `ashby_list_jobs` | List open jobs with IDs, titles, department, location, status |
+| `ashby_get_job_details` | Full job details including interview plan stages |
+| `ashby_list_candidates_for_job` | List candidates/applications for a job with stage and status |
+| `ashby_get_candidate` | Comprehensive candidate profile with all applications |
+| `ashby_get_application_details` | Full application with stage history, feedback, evaluations |
+| `ashby_get_candidate_notes` | All notes on a candidate |
+| `ashby_search_candidates` | Search candidates by name or email |
+| `ashby_list_interview_stages` | List all interview stages (pipeline reference) |
+| `ashby_get_feedback` | Submitted feedback/scorecards for an application |
+
+### Write tools
+
+| Tool | Description |
+|------|-------------|
+| `ashby_add_candidate_note` | Add an evaluation note to a candidate |
+| `ashby_move_application_stage` | Move an application to a different interview stage |
+| `ashby_add_candidate_tag` | Tag a candidate (e.g. "Strong Hire") |
+
+## Example Prompts
+
+```
+Show me all open engineering jobs.
+
+List the candidates for the Senior Backend Engineer role and summarize where each one is in the pipeline.
+
+Pull up the full profile for candidate Jane Smith — I want to see her resume info, application history, and any existing notes.
+
+Review the feedback submitted for application abc-123 and summarize the interviewer evaluations.
+
+Add a note to candidate xyz-456: "Strong technical skills demonstrated in system design round. Recommend advancing to final interview."
+
+Move application abc-123 to the "Final Interview" stage.
+```
+
+## Testing
+
+### Verify API connectivity
+
+```bash
+ASHBY_API_KEY=your-key npm run test-api
+```
+
+### Test with MCP Inspector
+
+```bash
+ASHBY_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+### Run directly
+
+```bash
+ASHBY_API_KEY=your-key node dist/index.js
+```
+
+The server communicates over stdio — it will start silently and wait for MCP protocol messages.
+
+## Development
+
+```bash
+npm install
+npm run build    # compile TypeScript to dist/
+npm start        # run the built server
+```

package/dist/ashby-client.d.ts

@@ -0,0 +1,28 @@
+export declare class AshbyClient {
+    private authHeader;
+    constructor();
+    /**
+     * Make a single request to an Ashby API endpoint.
+     * All Ashby endpoints are POST with JSON bodies.
+     */
+    request<T>(endpoint: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a paginated request, returning a single page of results
+     * along with pagination metadata.
+     */
+    requestList<T>(endpoint: string, params?: Record<string, unknown>): Promise<{
+        results: T[];
+        moreDataAvailable: boolean;
+        nextCursor?: string;
+    }>;
+    /**
+     * Async generator that yields items across all pages.
+     * Useful when you need to collect all results.
+     */
+    paginate<T>(endpoint: string, params?: Record<string, unknown>): AsyncGenerator<T>;
+}
+export declare class AshbyApiError extends Error {
+    readonly httpStatus?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, httpStatus?: number | undefined, code?: string | undefined);
+}

package/dist/ashby-client.js

@@ -0,0 +1,104 @@
+const BASE_URL = "https://api.ashbyhq.com";
+export class AshbyClient {
+    authHeader;
+    constructor() {
+        const apiKey = process.env.ASHBY_API_KEY;
+        if (!apiKey) {
+            throw new Error("ASHBY_API_KEY environment variable is required. " +
+                "Get an API key from your Ashby admin settings.");
+        }
+        this.authHeader = `Basic ${Buffer.from(`${apiKey}:`).toString("base64")}`;
+    }
+    /**
+     * Make a single request to an Ashby API endpoint.
+     * All Ashby endpoints are POST with JSON bodies.
+     */
+    async request(endpoint, params) {
+        const url = `${BASE_URL}/${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                Authorization: this.authHeader,
+            },
+            body: JSON.stringify(params ?? {}),
+        });
+        if (!response.ok) {
+            throw new AshbyApiError(`HTTP ${response.status}: ${response.statusText}`, response.status);
+        }
+        const data = (await response.json());
+        if (!data.success) {
+            const err = data;
+            const message = err.errorInfo?.message ??
+                err.errors?.join(", ") ??
+                "Unknown Ashby API error";
+            throw new AshbyApiError(message, 200, err.errorInfo?.code);
+        }
+        return data.results;
+    }
+    /**
+     * Make a paginated request, returning a single page of results
+     * along with pagination metadata.
+     */
+    async requestList(endpoint, params) {
+        const url = `${BASE_URL}/${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                Authorization: this.authHeader,
+            },
+            body: JSON.stringify(params ?? {}),
+        });
+        if (!response.ok) {
+            throw new AshbyApiError(`HTTP ${response.status}: ${response.statusText}`, response.status);
+        }
+        const data = (await response.json());
+        if (!data.success) {
+            const err = data;
+            const message = err.errorInfo?.message ??
+                err.errors?.join(", ") ??
+                "Unknown Ashby API error";
+            throw new AshbyApiError(message, 200, err.errorInfo?.code);
+        }
+        const ok = data;
+        return {
+            results: ok.results,
+            moreDataAvailable: ok.moreDataAvailable,
+            nextCursor: ok.nextCursor,
+        };
+    }
+    /**
+     * Async generator that yields items across all pages.
+     * Useful when you need to collect all results.
+     */
+    async *paginate(endpoint, params) {
+        let cursor;
+        let hasMore = true;
+        while (hasMore) {
+            const reqParams = { ...params };
+            if (cursor) {
+                reqParams.cursor = cursor;
+            }
+            const page = await this.requestList(endpoint, reqParams);
+            for (const item of page.results) {
+                yield item;
+            }
+            hasMore = page.moreDataAvailable;
+            cursor = page.nextCursor;
+        }
+    }
+}
+export class AshbyApiError extends Error {
+    httpStatus;
+    code;
+    constructor(message, httpStatus, code) {
+        super(message);
+        this.httpStatus = httpStatus;
+        this.code = code;
+        this.name = "AshbyApiError";
+    }
+}
+//# sourceMappingURL=ashby-client.js.map

package/dist/ashby-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ashby-client.js","sourceRoot":"","sources":["../src/ashby-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,480 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { AshbyClient, AshbyApiError } from "./ashby-client.js";
+function error(e) {
+    const msg = e instanceof AshbyApiError
+        ? `Ashby API error: ${e.message}${e.code ? ` (code: ${e.code})` : ""}`
+        : `Error: ${e instanceof Error ? e.message : String(e)}`;
+    return { content: [{ type: "text", text: msg }] };
+}
+function json(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+// ─── Server factory ─────────────────────────────────────────────────────────
+export function createServer() {
+    const server = new McpServer({
+        name: "ashby",
+        version: "1.0.0",
+    });
+    const client = new AshbyClient();
+    // ── 1. ashby_list_jobs ──────────────────────────────────────────────────
+    server.tool("ashby_list_jobs", `List jobs from Ashby with their IDs, titles, department, location, and status.
+
+Use this to discover what positions exist before looking at candidates.
+Returns a paginated list — pass the next_cursor value to fetch more results.
+The status filter is applied client-side since the Ashby API returns all jobs.
+
+Response: items[] (id, title, status, locationId, departmentId), has_more, next_cursor.`, {
+        status: z
+            .enum(["Open", "Closed", "Archived", "Draft", "All"])
+            .default("Open")
+            .describe('Filter by job status. Use "All" to return every job. Defaults to "Open".'),
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe("Max results per page (1-100). Defaults to 25."),
+        cursor: z
+            .string()
+            .optional()
+            .describe("Pagination cursor from a previous response."),
+    }, async ({ status, limit, cursor }) => {
+        try {
+            const params = { limit };
+            if (cursor)
+                params.cursor = cursor;
+            const page = await client.requestList("job.list", params);
+            const filtered = status === "All"
+                ? page.results
+                : page.results.filter((j) => j.status === status);
+            return json({
+                items: filtered.map((j) => ({
+                    id: j.id,
+                    title: j.title,
+                    status: j.status,
+                    locationId: j.locationId ?? null,
+                    departmentId: j.departmentId ?? null,
+                    createdAt: j.createdAt,
+                    updatedAt: j.updatedAt,
+                })),
+                has_more: page.moreDataAvailable,
+                next_cursor: page.nextCursor ?? null,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 2. ashby_get_job_details ────────────────────────────────────────────
+    server.tool("ashby_get_job_details", `Get full details for a specific job including its interview plan stages.
+
+Use this after ashby_list_jobs to understand a position's requirements and hiring pipeline.
+Fetches the job, then resolves its interview plan stages automatically.
+
+Response: job (id, title, status, hiringTeam, customFields, locationId, departmentId), interview_stages[] (id, title, type, order).`, {
+        job_id: z.string().describe("The job ID (UUID) to fetch details for."),
+    }, async ({ job_id }) => {
+        try {
+            const job = await client.request("job.info", { id: job_id });
+            // Fetch stages for the job's interview plan(s)
+            const planIds = job.interviewPlanIds ?? (job.defaultInterviewPlanId ? [job.defaultInterviewPlanId] : []);
+            const stageResults = await Promise.all(planIds.map((planId) => client
+                .requestList("interviewStage.list", { interviewPlanId: planId })
+                .then((r) => r.results)
+                .catch(() => [])));
+            const stages = stageResults.flat();
+            return json({
+                job: {
+                    id: job.id,
+                    title: job.title,
+                    status: job.status,
+                    employmentType: job.employmentType ?? null,
+                    locationId: job.locationId ?? null,
+                    departmentId: job.departmentId ?? null,
+                    hiringTeam: (job.hiringTeam ?? []).map((m) => ({
+                        name: `${m.firstName} ${m.lastName}`,
+                        email: m.email,
+                        role: m.role,
+                    })),
+                    customFields: job.customFields ?? [],
+                    createdAt: job.createdAt,
+                    updatedAt: job.updatedAt,
+                },
+                interview_stages: stages
+                    .sort((a, b) => a.orderInInterviewPlan - b.orderInInterviewPlan)
+                    .map((s) => ({
+                    id: s.id,
+                    title: s.title,
+                    type: s.type,
+                    order: s.orderInInterviewPlan,
+                })),
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 3. ashby_list_candidates_for_job ────────────────────────────────────
+    server.tool("ashby_list_candidates_for_job", `List all candidates/applications for a specific job.
+
+Returns each application with the candidate's name, current interview stage, and status.
+Use this to see the pipeline for a job. Pass next_cursor to paginate.
+
+Response: items[] (application_id, candidate_id, candidate_name, status, current_stage, source, createdAt), has_more, next_cursor.`, {
+        job_id: z.string().describe("The job ID (UUID) to list candidates for."),
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe("Max results per page (1-100). Defaults to 25."),
+        cursor: z
+            .string()
+            .optional()
+            .describe("Pagination cursor from a previous response."),
+    }, async ({ job_id, limit, cursor }) => {
+        try {
+            const params = { jobId: job_id, limit };
+            if (cursor)
+                params.cursor = cursor;
+            const page = await client.requestList("application.list", params);
+            return json({
+                items: page.results.map((app) => ({
+                    application_id: app.id,
+                    candidate_id: app.candidate.id,
+                    candidate_name: app.candidate.name,
+                    candidate_email: app.candidate.primaryEmailAddress?.value ?? null,
+                    status: app.status,
+                    current_stage: app.currentInterviewStage
+                        ? {
+                            id: app.currentInterviewStage.id,
+                            title: app.currentInterviewStage.title,
+                            type: app.currentInterviewStage.type,
+                        }
+                        : null,
+                    source: app.source?.title ?? null,
+                    createdAt: app.createdAt,
+                })),
+                has_more: page.moreDataAvailable,
+                next_cursor: page.nextCursor ?? null,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 4. ashby_get_candidate ──────────────────────────────────────────────
+    server.tool("ashby_get_candidate", `Get a comprehensive candidate profile.
+
+Returns everything needed to evaluate a candidate: name, contact info, social links, tags,
+resume/file handles, source, and all their applications with current stages.
+Fetches the candidate profile, then resolves each application for full details.
+
+Response: candidate (id, name, email, phone, socialLinks, tags, source, profileUrl, fileHandles), applications[] (id, status, job, current_stage, source, hiringTeam).`, {
+        candidate_id: z.string().describe("The candidate ID (UUID) to fetch."),
+    }, async ({ candidate_id }) => {
+        try {
+            const candidate = await client.request("candidate.info", { id: candidate_id });
+            // Resolve full application details from applicationIds
+            let applications = [];
+            const appIds = candidate.applicationIds ?? [];
+            if (appIds.length > 0) {
+                const appResults = await Promise.all(appIds.map((appId) => client
+                    .request("application.info", { applicationId: appId })
+                    .catch(() => null)));
+                applications = appResults.filter((a) => a !== null);
+            }
+            return json({
+                candidate: {
+                    id: candidate.id,
+                    name: candidate.name,
+                    email: candidate.primaryEmailAddress?.value ?? null,
+                    phone: candidate.primaryPhoneNumber?.value ?? null,
+                    socialLinks: candidate.socialLinks ?? [],
+                    tags: (candidate.tags ?? []).map((t) => ({ id: t.id, title: t.title })),
+                    source: candidate.source?.title ?? null,
+                    customFields: candidate.customFields ?? [],
+                    fileHandles: candidate.fileHandles ?? [],
+                    profileUrl: candidate.profileUrl ?? null,
+                },
+                applications: applications.map((app) => ({
+                    id: app.id,
+                    status: app.status,
+                    job: { id: app.job.id, title: app.job.title },
+                    current_stage: app.currentInterviewStage
+                        ? {
+                            id: app.currentInterviewStage.id,
+                            title: app.currentInterviewStage.title,
+                            type: app.currentInterviewStage.type,
+                        }
+                        : null,
+                    source: app.source?.title ?? null,
+                    hiringTeam: (app.hiringTeam ?? []).map((m) => ({
+                        name: `${m.firstName} ${m.lastName}`,
+                        email: m.email,
+                        role: m.role,
+                    })),
+                    createdAt: app.createdAt,
+                })),
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 5. ashby_get_application_details ────────────────────────────────────
+    server.tool("ashby_get_application_details", `Get full application details including stage history, hiring team, feedback, and criteria evaluations.
+
+Use this to deep-dive into a specific application. Fires four API calls concurrently for speed.
+
+Response: application (id, status, candidate, job, current_stage, hiringTeam, source, customFields), stage_history[], criteria_evaluations[], feedback[].`, {
+        application_id: z.string().describe("The application ID (UUID) to fetch."),
+    }, async ({ application_id }) => {
+        try {
+            const [appInfo, historyPage, criteriaPage, feedbackPage] = await Promise.all([
+                client.request("application.info", { applicationId: application_id }),
+                client
+                    .requestList("application.listHistory", { applicationId: application_id })
+                    .catch(() => ({ results: [], moreDataAvailable: false })),
+                client
+                    .requestList("application.listCriteriaEvaluations", { applicationId: application_id })
+                    .catch(() => ({ results: [], moreDataAvailable: false })),
+                client
+                    .requestList("applicationFeedback.list", { applicationId: application_id })
+                    .catch(() => ({ results: [], moreDataAvailable: false })),
+            ]);
+            return json({
+                application: {
+                    id: appInfo.id,
+                    status: appInfo.status,
+                    candidate: {
+                        id: appInfo.candidate.id,
+                        name: appInfo.candidate.name,
+                        email: appInfo.candidate.primaryEmailAddress?.value ?? null,
+                    },
+                    job: { id: appInfo.job.id, title: appInfo.job.title },
+                    current_stage: appInfo.currentInterviewStage
+                        ? {
+                            id: appInfo.currentInterviewStage.id,
+                            title: appInfo.currentInterviewStage.title,
+                            type: appInfo.currentInterviewStage.type,
+                            order: appInfo.currentInterviewStage.orderInInterviewPlan,
+                        }
+                        : null,
+                    hiringTeam: (appInfo.hiringTeam ?? []).map((m) => ({
+                        name: `${m.firstName} ${m.lastName}`,
+                        email: m.email,
+                        role: m.role,
+                    })),
+                    source: appInfo.source?.title ?? null,
+                    customFields: appInfo.customFields ?? [],
+                    resumeFileHandle: appInfo.resumeFileHandle ?? null,
+                    createdAt: appInfo.createdAt,
+                    updatedAt: appInfo.updatedAt,
+                },
+                stage_history: historyPage.results.map((h) => ({
+                    stageId: h.stageId,
+                    title: h.title,
+                    enteredAt: h.enteredStageAt,
+                    leftAt: h.leftStageAt ?? null,
+                    stageNumber: h.stageNumber,
+                })),
+                criteria_evaluations: criteriaPage.results,
+                feedback: feedbackPage.results,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 6. ashby_get_candidate_notes ────────────────────────────────────────
+    server.tool("ashby_get_candidate_notes", `List all notes on a candidate.
+
+Use this to see existing evaluation notes or comments left by the hiring team.
+
+Response: notes[] (id, content, createdAt, author).`, {
+        candidate_id: z.string().describe("The candidate ID (UUID) to fetch notes for."),
+    }, async ({ candidate_id }) => {
+        try {
+            const page = await client.requestList("candidate.listNotes", { candidateId: candidate_id, limit: 100 });
+            return json({
+                notes: page.results.map((n) => ({
+                    id: n.id,
+                    content: n.content,
+                    createdAt: n.createdAt,
+                    author: n.author
+                        ? `${n.author.firstName} ${n.author.lastName} (${n.author.email})`
+                        : null,
+                })),
+                has_more: page.moreDataAvailable,
+                next_cursor: page.nextCursor ?? null,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 7. ashby_search_candidates ──────────────────────────────────────────
+    server.tool("ashby_search_candidates", `Search for candidates by name or email.
+
+Use this when you know a candidate's name or email but not their ID.
+Both name and email use AND logic if both provided. Max 100 results.
+
+Response: candidates[] (id, name, email, phone).`, {
+        query: z.string().describe("Candidate name to search for."),
+        email: z
+            .string()
+            .optional()
+            .describe("Optional email to narrow search (AND logic with name)."),
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe("Max results (1-100). Defaults to 25."),
+    }, async ({ query, email, limit }) => {
+        try {
+            const params = { name: query, limit };
+            if (email)
+                params.email = email;
+            const results = await client.request("candidate.search", params);
+            return json({
+                candidates: results.map((c) => ({
+                    id: c.id,
+                    name: c.name,
+                    email: c.primaryEmailAddress?.value ?? null,
+                    phone: c.primaryPhoneNumber?.value ?? null,
+                })),
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 8. ashby_list_interview_stages ──────────────────────────────────────
+    server.tool("ashby_list_interview_stages", `List all interview stages across all interview plans.
+
+Use this to understand the hiring pipeline and get stage IDs for ashby_move_application_stage.
+Fetches all interview plans, then resolves stages for each.
+
+Response: plans[] (plan_id, plan_title, stages[] (id, title, type, order)).`, {}, async () => {
+        try {
+            const planPage = await client.requestList("interviewPlan.list", {});
+            const plansWithStages = await Promise.all(planPage.results.map(async (plan) => {
+                const stagePage = await client
+                    .requestList("interviewStage.list", { interviewPlanId: plan.id })
+                    .catch(() => ({ results: [], moreDataAvailable: false }));
+                return {
+                    plan_id: plan.id,
+                    plan_title: plan.title,
+                    stages: stagePage.results
+                        .sort((a, b) => a.orderInInterviewPlan - b.orderInInterviewPlan)
+                        .map((s) => ({
+                        id: s.id,
+                        title: s.title,
+                        type: s.type,
+                        order: s.orderInInterviewPlan,
+                    })),
+                };
+            }));
+            return json({ plans: plansWithStages });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 9. ashby_get_feedback ───────────────────────────────────────────────
+    server.tool("ashby_get_feedback", `Get submitted feedback/scorecards for an application.
+
+Use this to review interviewer evaluations and scores.
+
+Response: feedback[] (form definition with sections/fields, submitted values).`, {
+        application_id: z.string().describe("The application ID (UUID) to fetch feedback for."),
+    }, async ({ application_id }) => {
+        try {
+            const page = await client.requestList("applicationFeedback.list", { applicationId: application_id });
+            return json({
+                feedback: page.results,
+                has_more: page.moreDataAvailable,
+                next_cursor: page.nextCursor ?? null,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 10. ashby_add_candidate_note ────────────────────────────────────────
+    server.tool("ashby_add_candidate_note", `Add an evaluation note to a candidate.
+
+Use this to record your assessment or recommendations. The note will be visible to the hiring team in Ashby.
+
+Response: note_id, confirmation message.`, {
+        candidate_id: z.string().describe("The candidate ID (UUID) to add a note to."),
+        note: z.string().describe("The note content (plain text). Visible to the hiring team."),
+    }, async ({ candidate_id, note }) => {
+        try {
+            const result = await client.request("candidate.createNote", { candidateId: candidate_id, note });
+            return json({
+                note_id: result.id,
+                message: `Note added to candidate ${candidate_id}.`,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 11. ashby_move_application_stage ────────────────────────────────────
+    server.tool("ashby_move_application_stage", `Move an application to a different interview stage.
+
+Use this to advance a candidate through the pipeline. Get stage IDs from ashby_list_interview_stages.
+Moving to an "Archived" type stage requires an archive reason — use only for active transitions.
+
+Response: updated application with new current_stage.`, {
+        application_id: z.string().describe("The application ID (UUID) to move."),
+        stage_id: z.string().describe("The target interview stage ID (UUID). Get from ashby_list_interview_stages."),
+    }, async ({ application_id, stage_id }) => {
+        try {
+            const result = await client.request("application.changeStage", { applicationId: application_id, interviewStageId: stage_id });
+            return json({
+                application_id: result.id,
+                new_stage: result.currentInterviewStage
+                    ? {
+                        id: result.currentInterviewStage.id,
+                        title: result.currentInterviewStage.title,
+                        type: result.currentInterviewStage.type,
+                    }
+                    : null,
+                status: result.status,
+                message: `Application moved to stage "${result.currentInterviewStage?.title ?? stage_id}".`,
+            });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    // ── 12. ashby_add_candidate_tag ─────────────────────────────────────────
+    server.tool("ashby_add_candidate_tag", `Tag a candidate with a label (e.g. "Strong Hire", "Needs Review").
+
+Use this to categorize candidates during evaluation. You need the tag ID from Ashby admin settings.
+
+Response: confirmation message.`, {
+        candidate_id: z.string().describe("The candidate ID (UUID) to tag."),
+        tag_id: z.string().describe("The tag ID (UUID). Tags are configured in Ashby admin settings."),
+    }, async ({ candidate_id, tag_id }) => {
+        try {
+            await client.request("candidate.addTag", {
+                candidateId: candidate_id,
+                tagId: tag_id,
+            });
+            return json({ message: `Tag ${tag_id} added to candidate ${candidate_id}.` });
+        }
+        catch (e) {
+            return error(e);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,167 @@
+export interface AshbySuccessResponse<T> {
+    success: true;
+    results: T;
+}
+export interface AshbyPaginatedResponse<T> {
+    success: true;
+    results: T[];
+    moreDataAvailable: boolean;
+    nextCursor?: string;
+}
+export interface AshbyErrorResponse {
+    success: false;
+    errors?: string[];
+    errorInfo?: {
+        code: string;
+        message?: string;
+        requestId?: string;
+    };
+}
+export type AshbyResponse<T> = AshbySuccessResponse<T> | AshbyErrorResponse;
+export type AshbyListResponse<T> = AshbyPaginatedResponse<T> | AshbyErrorResponse;
+export interface ContactInfo {
+    value: string;
+    type: string;
+    isPrimary: boolean;
+}
+export interface CustomField {
+    id: string;
+    isPrivate: boolean;
+    title: string;
+    value: unknown;
+    valueLabel?: string | string[];
+}
+export interface HiringTeamMember {
+    userId: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    role: string;
+}
+export interface SourceInfo {
+    id: string;
+    title: string;
+    isArchived: boolean;
+}
+export interface InterviewStageRef {
+    id: string;
+    title: string;
+    type: string;
+    orderInInterviewPlan: number;
+    interviewPlanId?: string;
+}
+export interface JobRef {
+    id: string;
+    title: string;
+    locationId?: string;
+    departmentId?: string;
+}
+export interface CandidateRef {
+    id: string;
+    name: string;
+    primaryEmailAddress?: ContactInfo;
+    primaryPhoneNumber?: ContactInfo;
+}
+export interface TagRef {
+    id: string;
+    title: string;
+    isArchived: boolean;
+}
+export interface FileHandle {
+    id: string;
+    name: string;
+    handle: string;
+}
+export interface Job {
+    id: string;
+    title: string;
+    status: string;
+    employmentType?: string;
+    confidential?: boolean;
+    locationId?: string;
+    departmentId?: string;
+    defaultInterviewPlanId?: string;
+    interviewPlanIds?: string[];
+    customFields?: CustomField[];
+    hiringTeam?: HiringTeamMember[];
+    createdAt: string;
+    updatedAt: string;
+    openedAt?: string;
+    closedAt?: string;
+}
+export interface InterviewStage {
+    id: string;
+    title: string;
+    type: string;
+    orderInInterviewPlan: number;
+    interviewStageGroupId?: string;
+}
+export interface InterviewPlan {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Application {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    status: "Hired" | "Archived" | "Active" | "Lead";
+    candidate: CandidateRef;
+    currentInterviewStage?: InterviewStageRef;
+    job: JobRef;
+    source?: SourceInfo;
+    archiveReason?: {
+        id: string;
+        text: string;
+        reasonType: string;
+    };
+    hiringTeam?: HiringTeamMember[];
+    customFields?: CustomField[];
+    resumeFileHandle?: FileHandle;
+    applicationHistory?: ApplicationHistoryEntry[];
+}
+export interface ApplicationHistoryEntry {
+    id: string;
+    stageId: string;
+    title: string;
+    enteredStageAt: string;
+    leftStageAt?: string;
+    stageNumber: number;
+}
+export interface CriteriaEvaluation {
+    [key: string]: unknown;
+}
+export interface ApplicationFeedback {
+    [key: string]: unknown;
+}
+export interface Candidate {
+    id: string;
+    name: string;
+    primaryEmailAddress?: ContactInfo;
+    primaryPhoneNumber?: ContactInfo;
+    emailAddresses?: ContactInfo[];
+    phoneNumbers?: ContactInfo[];
+    socialLinks?: {
+        type: string;
+        url: string;
+    }[];
+    tags?: TagRef[];
+    source?: SourceInfo;
+    customFields?: CustomField[];
+    applicationIds?: string[];
+    fileHandles?: FileHandle[];
+    profileUrl?: string;
+}
+export interface CandidateNote {
+    id: string;
+    createdAt: string;
+    isPrivate: boolean;
+    content: string;
+    author?: {
+        id: string;
+        firstName: string;
+        lastName: string;
+        email: string;
+    };
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Ashby API response wrappers ────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ashby-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Ashby ATS — candidate evaluation workflow",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ashby-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dewierwan/ashby-mcp"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "test-api": "tsx scripts/test-api.ts"
+  },
+  "keywords": ["mcp", "ashby", "ats", "recruiting", "hiring", "applicant-tracking"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3"
+  }
+}