@himanshu31shr/linkedin-mcp-server 1.0.0

package/dist/schemas/social-actions.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/** Valid LinkedIn reaction types */
+export declare const REACTION_TYPES: readonly ["LIKE", "CELEBRATE", "SUPPORT", "LOVE", "INSIGHTFUL", "CURIOUS"];
+export type ReactionType = (typeof REACTION_TYPES)[number];
+/**
+ * Schema for get_post_comments tool.
+ */
+export declare const GetPostCommentsSchema: z.ZodObject<{
+    postUrn: z.ZodString;
+    count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    start: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    postUrn: string;
+    count: number;
+    start: number;
+}, {
+    postUrn: string;
+    count?: number | undefined;
+    start?: number | undefined;
+}>;
+export type GetPostCommentsInput = z.infer<typeof GetPostCommentsSchema>;
+/**
+ * Schema for create_comment tool.
+ */
+export declare const CreateCommentSchema: z.ZodObject<{
+    postUrn: z.ZodString;
+    text: z.ZodString;
+    authorUrn: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    postUrn: string;
+    authorUrn?: string | undefined;
+}, {
+    text: string;
+    postUrn: string;
+    authorUrn?: string | undefined;
+}>;
+export type CreateCommentInput = z.infer<typeof CreateCommentSchema>;
+/**
+ * Schema for delete_comment tool.
+ */
+export declare const DeleteCommentSchema: z.ZodObject<{
+    commentUrn: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    commentUrn: string;
+}, {
+    commentUrn: string;
+}>;
+export type DeleteCommentInput = z.infer<typeof DeleteCommentSchema>;
+/**
+ * Schema for add_reaction tool.
+ */
+export declare const AddReactionSchema: z.ZodObject<{
+    postUrn: z.ZodString;
+    reactionType: z.ZodEnum<["LIKE", "CELEBRATE", "SUPPORT", "LOVE", "INSIGHTFUL", "CURIOUS"]>;
+}, "strip", z.ZodTypeAny, {
+    postUrn: string;
+    reactionType: "LIKE" | "CELEBRATE" | "SUPPORT" | "LOVE" | "INSIGHTFUL" | "CURIOUS";
+}, {
+    postUrn: string;
+    reactionType: "LIKE" | "CELEBRATE" | "SUPPORT" | "LOVE" | "INSIGHTFUL" | "CURIOUS";
+}>;
+export type AddReactionInput = z.infer<typeof AddReactionSchema>;
+/**
+ * Schema for remove_reaction tool.
+ */
+export declare const RemoveReactionSchema: z.ZodObject<{
+    postUrn: z.ZodString;
+    reactionType: z.ZodEnum<["LIKE", "CELEBRATE", "SUPPORT", "LOVE", "INSIGHTFUL", "CURIOUS"]>;
+}, "strip", z.ZodTypeAny, {
+    postUrn: string;
+    reactionType: "LIKE" | "CELEBRATE" | "SUPPORT" | "LOVE" | "INSIGHTFUL" | "CURIOUS";
+}, {
+    postUrn: string;
+    reactionType: "LIKE" | "CELEBRATE" | "SUPPORT" | "LOVE" | "INSIGHTFUL" | "CURIOUS";
+}>;
+export type RemoveReactionInput = z.infer<typeof RemoveReactionSchema>;
+//# sourceMappingURL=social-actions.d.ts.map

package/dist/schemas/social-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-actions.d.ts","sourceRoot":"","sources":["../../src/schemas/social-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oCAAoC;AACpC,eAAO,MAAM,cAAc,4EAOjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAmBhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAY9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;EAI9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAO5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schemas/social-actions.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+/** Valid LinkedIn reaction types */
+export const REACTION_TYPES = [
+    'LIKE',
+    'CELEBRATE',
+    'SUPPORT',
+    'LOVE',
+    'INSIGHTFUL',
+    'CURIOUS',
+];
+/**
+ * Schema for get_post_comments tool.
+ */
+export const GetPostCommentsSchema = z.object({
+    postUrn: z
+        .string()
+        .describe('The URN of the post to get comments for'),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .default(10)
+        .describe('Number of comments to retrieve (1-100, default 10)'),
+    start: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe('Pagination offset (default 0)'),
+});
+/**
+ * Schema for create_comment tool.
+ */
+export const CreateCommentSchema = z.object({
+    postUrn: z
+        .string()
+        .describe('The URN of the post to comment on'),
+    text: z
+        .string()
+        .min(1)
+        .describe('The text content of the comment'),
+    authorUrn: z
+        .string()
+        .optional()
+        .describe('The URN of the author (defaults to authenticated user)'),
+});
+/**
+ * Schema for delete_comment tool.
+ */
+export const DeleteCommentSchema = z.object({
+    commentUrn: z
+        .string()
+        .describe('The full URN of the comment to delete (e.g., urn:li:comment:(urn:li:activity:123456,789))'),
+});
+/**
+ * Schema for add_reaction tool.
+ */
+export const AddReactionSchema = z.object({
+    postUrn: z
+        .string()
+        .describe('The URN of the post to react to'),
+    reactionType: z
+        .enum(REACTION_TYPES)
+        .describe('The type of reaction to add'),
+});
+/**
+ * Schema for remove_reaction tool.
+ */
+export const RemoveReactionSchema = z.object({
+    postUrn: z
+        .string()
+        .describe('The URN of the post to remove the reaction from'),
+    reactionType: z
+        .enum(REACTION_TYPES)
+        .describe('The type of reaction to remove'),
+});
+//# sourceMappingURL=social-actions.js.map

package/dist/schemas/social-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-actions.js","sourceRoot":"","sources":["../../src/schemas/social-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM;IACN,WAAW;IACX,SAAS;IACT,MAAM;IACN,YAAY;IACZ,SAAS;CACD,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,yCAAyC,CAAC;IACtD,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oDAAoD,CAAC;IACjE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,mCAAmC,CAAC;IAChD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,2FAA2F,CAAC;CACzG,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,CAAC,gCAAgC,CAAC;CAC9C,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure the LinkedIn MCP Server.
+ * Registers all tool groups against a single LinkedInClient instance.
+ *
+ * @param accessToken — Optional OAuth 2.0 access token. Falls back to LINKEDIN_ACCESS_TOKEN env var.
+ * @returns Configured McpServer ready for transport connection.
+ */
+export declare function createServer(accessToken?: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAmB5D"}

package/dist/server.js

@@ -0,0 +1,29 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { LinkedInClient } from './services/linkedin-client.js';
+import { registerProfileTools, registerPostTools, registerMediaTools, registerOrganizationTools, registerSocialActionTools, registerOrgAnalyticsTools, } from './tools/index.js';
+import { createChildLogger } from './utils/logger.js';
+const log = createChildLogger('server');
+/**
+ * Create and configure the LinkedIn MCP Server.
+ * Registers all tool groups against a single LinkedInClient instance.
+ *
+ * @param accessToken — Optional OAuth 2.0 access token. Falls back to LINKEDIN_ACCESS_TOKEN env var.
+ * @returns Configured McpServer ready for transport connection.
+ */
+export function createServer(accessToken) {
+    const server = new McpServer({
+        name: 'linkedin-mcp-server',
+        version: '1.0.0',
+    });
+    const client = new LinkedInClient(accessToken);
+    // Register all tool groups
+    registerProfileTools(server, client);
+    registerPostTools(server, client);
+    registerMediaTools(server, client);
+    registerOrganizationTools(server, client);
+    registerSocialActionTools(server, client);
+    registerOrgAnalyticsTools(server, client);
+    log.info('CAVEMAN: All tool groups registered successfully');
+    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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,WAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IAE/C,2BAA2B;IAC3B,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,GAAG,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAE7D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/linkedin-client.d.ts

@@ -0,0 +1,55 @@
+/** HTTP methods supported by the client */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/** Options for making a LinkedIn API request */
+export interface LinkedInRequestOptions {
+    /** HTTP method */
+    method: HttpMethod;
+    /** API path (appended to base URL) */
+    path: string;
+    /** Use /rest base URL (true, default) or /v2 base URL (false) */
+    useRestApi?: boolean;
+    /** Request body (will be JSON-serialized) */
+    body?: Record<string, unknown>;
+    /** Additional query parameters */
+    params?: Record<string, string>;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+/**
+ * LinkedIn REST API client.
+ * Handles authentication, required headers, error parsing, and rate limit awareness.
+ */
+export declare class LinkedInClient {
+    private accessToken;
+    constructor(accessToken?: string);
+    /**
+     * Make an authenticated request to the LinkedIn API.
+     */
+    request<T = unknown>(options: LinkedInRequestOptions): Promise<T>;
+    /**
+     * Convenience method for GET requests.
+     */
+    get<T = unknown>(path: string, params?: Record<string, string>, useRestApi?: boolean): Promise<T>;
+    /**
+     * Convenience method for POST requests.
+     */
+    post<T = unknown>(path: string, body?: Record<string, unknown>, useRestApi?: boolean): Promise<T>;
+    /**
+     * Convenience method for DELETE requests.
+     */
+    delete<T = unknown>(path: string, useRestApi?: boolean): Promise<T>;
+    /**
+     * Convenience method for PATCH requests.
+     */
+    patch<T = unknown>(path: string, body?: Record<string, unknown>, useRestApi?: boolean): Promise<T>;
+    /**
+     * Upload binary data to a LinkedIn upload URL.
+     * Used for image/video/document uploads where LinkedIn provides a pre-signed URL.
+     */
+    uploadBinary(uploadUrl: string, data: Uint8Array, contentType: string): Promise<void>;
+    /**
+     * Extract a useful error message from a LinkedIn API error response.
+     */
+    private extractApiErrorMessage;
+}
+//# sourceMappingURL=linkedin-client.d.ts.map

package/dist/services/linkedin-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin-client.d.ts","sourceRoot":"","sources":["../../src/services/linkedin-client.ts"],"names":[],"mappings":"AAYA,2CAA2C;AAC3C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,CAAC,EAAE,MAAM;IAShC;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC;IA2EvE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpG;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpG;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrG;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3F;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAiB/B"}

package/dist/services/linkedin-client.js

@@ -0,0 +1,148 @@
+import { AuthenticationError, LinkedInApiError } from '../utils/errors.js';
+import { createChildLogger } from '../utils/logger.js';
+const log = createChildLogger('linkedin-client');
+/** LinkedIn API version header value (YYYYMM format) */
+const LINKEDIN_API_VERSION = '202406';
+/** Base URLs for LinkedIn API */
+const REST_BASE_URL = 'https://api.linkedin.com/rest';
+const V2_BASE_URL = 'https://api.linkedin.com/v2';
+/**
+ * LinkedIn REST API client.
+ * Handles authentication, required headers, error parsing, and rate limit awareness.
+ */
+export class LinkedInClient {
+    accessToken;
+    constructor(accessToken) {
+        const token = accessToken ?? process.env.LINKEDIN_ACCESS_TOKEN;
+        if (!token) {
+            throw new AuthenticationError();
+        }
+        this.accessToken = token;
+        log.info('CAVEMAN: LinkedInClient initialized with token (length=%d)', token.length);
+    }
+    /**
+     * Make an authenticated request to the LinkedIn API.
+     */
+    async request(options) {
+        const baseUrl = options.useRestApi === false ? V2_BASE_URL : REST_BASE_URL;
+        const url = new URL(`${baseUrl}${options.path}`);
+        // Append query params
+        if (options.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+            'LinkedIn-Version': LINKEDIN_API_VERSION,
+            'X-Restli-Protocol-Version': '2.0.0',
+            ...options.headers,
+        };
+        // Add Content-Type for requests with bodies
+        if (options.body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        log.debug('CAVEMAN: %s %s', options.method, url.toString());
+        const response = await fetch(url.toString(), {
+            method: options.method,
+            headers,
+            body: options.body ? JSON.stringify(options.body) : undefined,
+        });
+        log.debug('CAVEMAN: Response status=%d', response.status);
+        // Handle rate limiting
+        if (response.status === 429) {
+            const retryAfter = response.headers.get('Retry-After');
+            throw new LinkedInApiError(429, `Rate limited by LinkedIn API. ${retryAfter ? `Retry after ${retryAfter} seconds.` : 'Please try again later.'}`);
+        }
+        // Handle no-content responses (e.g., DELETE)
+        if (response.status === 204) {
+            return undefined;
+        }
+        // Parse response body
+        const responseText = await response.text();
+        let responseBody;
+        if (responseText) {
+            try {
+                responseBody = JSON.parse(responseText);
+            }
+            catch {
+                // If response is not JSON, wrap it
+                responseBody = { rawResponse: responseText };
+            }
+        }
+        // Handle error responses
+        if (!response.ok) {
+            const errorMessage = this.extractApiErrorMessage(responseBody, response.status);
+            log.error('CAVEMAN: API error: %s', errorMessage);
+            throw new LinkedInApiError(response.status, errorMessage, typeof responseBody === 'object' ? responseBody : undefined);
+        }
+        log.debug('CAVEMAN: Request successful');
+        return responseBody;
+    }
+    /**
+     * Convenience method for GET requests.
+     */
+    async get(path, params, useRestApi = true) {
+        return this.request({ method: 'GET', path, params, useRestApi });
+    }
+    /**
+     * Convenience method for POST requests.
+     */
+    async post(path, body, useRestApi = true) {
+        return this.request({ method: 'POST', path, body, useRestApi });
+    }
+    /**
+     * Convenience method for DELETE requests.
+     */
+    async delete(path, useRestApi = true) {
+        return this.request({ method: 'DELETE', path, useRestApi });
+    }
+    /**
+     * Convenience method for PATCH requests.
+     */
+    async patch(path, body, useRestApi = true) {
+        return this.request({ method: 'PATCH', path, body, useRestApi });
+    }
+    /**
+     * Upload binary data to a LinkedIn upload URL.
+     * Used for image/video/document uploads where LinkedIn provides a pre-signed URL.
+     */
+    async uploadBinary(uploadUrl, data, contentType) {
+        log.debug('CAVEMAN: Uploading binary to %s (size=%d, type=%s)', uploadUrl, data.length, contentType);
+        const response = await fetch(uploadUrl, {
+            method: 'PUT',
+            headers: {
+                Authorization: `Bearer ${this.accessToken}`,
+                'Content-Type': contentType,
+            },
+            body: data,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            log.error('CAVEMAN: Upload failed: status=%d, body=%s', response.status, text);
+            throw new LinkedInApiError(response.status, `Upload failed: ${text}`);
+        }
+        log.debug('CAVEMAN: Upload successful');
+    }
+    /**
+     * Extract a useful error message from a LinkedIn API error response.
+     */
+    extractApiErrorMessage(responseBody, status) {
+        if (responseBody && typeof responseBody === 'object') {
+            const body = responseBody;
+            // LinkedIn error format: { message: "...", status: 401 }
+            if (typeof body.message === 'string') {
+                return body.message;
+            }
+            // Alternative format: { error: "...", error_description: "..." }
+            if (typeof body.error_description === 'string') {
+                return body.error_description;
+            }
+            if (typeof body.error === 'string') {
+                return body.error;
+            }
+        }
+        return `LinkedIn API request failed with status ${status}`;
+    }
+}
+//# sourceMappingURL=linkedin-client.js.map

package/dist/services/linkedin-client.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+export { registerProfileTools } from './profile.js';
+export { registerPostTools } from './posts.js';
+export { registerMediaTools } from './media.js';
+export { registerOrganizationTools } from './organization.js';
+export { registerSocialActionTools } from './social-actions.js';
+export { registerOrgAnalyticsTools } from './org-analytics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+export { registerProfileTools } from './profile.js';
+export { registerPostTools } from './posts.js';
+export { registerMediaTools } from './media.js';
+export { registerOrganizationTools } from './organization.js';
+export { registerSocialActionTools } from './social-actions.js';
+export { registerOrgAnalyticsTools } from './org-analytics.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/media.d.ts

@@ -0,0 +1,30 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TextContent } from '@modelcontextprotocol/sdk/types.js';
+import { LinkedInClient } from '../services/linkedin-client.js';
+import { type UploadImageInput, type CreateImagePostInput, type CreateDocumentPostInput } from '../schemas/media.js';
+/**
+ * Upload an image to LinkedIn and return the image URN.
+ */
+export declare function uploadImage(client: LinkedInClient, input: UploadImageInput): Promise<{
+    content: TextContent[];
+    isError?: true;
+}>;
+/**
+ * Create a post with an image on LinkedIn.
+ */
+export declare function createImagePost(client: LinkedInClient, input: CreateImagePostInput): Promise<{
+    content: TextContent[];
+    isError?: true;
+}>;
+/**
+ * Create a post with a document (PDF, etc.) on LinkedIn.
+ */
+export declare function createDocumentPost(client: LinkedInClient, input: CreateDocumentPostInput): Promise<{
+    content: TextContent[];
+    isError?: true;
+}>;
+/**
+ * Register all media-related tools with the MCP server.
+ */
+export declare function registerMediaTools(server: McpServer, client: LinkedInClient): void;
+//# sourceMappingURL=media.d.ts.map

package/dist/tools/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AA2C7B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CAsCrD;AA4BD;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CA4CrD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CA8DrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAmClF"}