generate_linkedin_post
Transform any content into three LinkedIn post variants to optimize engagement. Input articles, newsletters, or notes to generate professional posts.
Instructions
Generate three LinkedIn post variants from any content (article, newsletter, notes, etc.) to optimize engagement.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The source content to transform into LinkedIn posts. Can be articles, emails, newsletters, notes, etc. | |
| content_type | No | Optional. A short description of the content type (e.g., 'article', 'newsletter', 'notes'). Defaults to 'article'. |
Implementation Reference
- cli.js:512-627 (handler)Handler for the 'generate_linkedin_post' tool. Validates input parameters 'content' and optional 'content_type', proxies the request to the backend API (https://ligo.ertiqah.com/api/mcp/generate-linkedin-post), handles the response containing post variants, and returns formatted text content with success or error status.
} else if (name === 'generate_linkedin_post') { console.error(`${packageName}: Received call for generate_linkedin_post tool.`); const apiKey = process.env.LINKEDIN_MCP_API_KEY; const content = args?.content; const contentType = args?.content_type || 'article'; if (!apiKey) { sendResponse({ jsonrpc: "2.0", error: { code: -32001, message: "Server Configuration Error: API Key not set." }, id }); return; } if (typeof content !== 'string' || content.trim() === '') { sendResponse({ jsonrpc: "2.0", error: { code: -32602, message: "Invalid arguments: 'content' (string) required." }, id }); return; } try { const headers = { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", "Accept": "application/json" }; const payload = { "content": content, "contentType": contentType }; console.error(`${packageName}: Calling generate post API: ${backendGeneratePostApiUrl} with payload:`, JSON.stringify(payload, null, 2)); const apiResponse = await axios.post(backendGeneratePostApiUrl, payload, { headers, timeout: 60000 }); console.error(`${packageName}: Generate post API response status: ${apiResponse.status}`); console.error(`${packageName}: Generate post API response data:`, JSON.stringify(apiResponse.data, null, 2)); if (apiResponse.data && apiResponse.data.success) { if (apiResponse.data.variants && Array.isArray(apiResponse.data.variants)) { // Handle the case where we get an array of variant posts const variants = apiResponse.data.variants; // Create content items - first a text description, then one item for each variant const contentItems = [ { type: "text", text: `Generated ${variants.length} LinkedIn post variants:` } ]; // Add each variant as a separate text item for better formatting variants.forEach((variant, index) => { contentItems.push({ type: "text", text: `Option ${index + 1}:\n${variant}` }); }); sendResponse({ jsonrpc: "2.0", result: { content: contentItems, isError: false }, id }); } else { // Fallback for backward compatibility sendResponse({ jsonrpc: "2.0", result: { content: [ { type: "text", text: apiResponse.data.message || "Successfully generated LinkedIn post, but no variants were returned. Please check the backend implementation." } ], isError: false }, id }); } } else { const errorMessage = apiResponse.data?.error || "Backend API Error (no detail)"; console.error(`${packageName}: Generate post API Error: ${errorMessage}`); sendResponse({ jsonrpc: "2.0", result: { content: [ { type: "text", text: `Failed to generate LinkedIn post: ${errorMessage}` } ], isError: true }, id }); } } catch (error) { let errorMessage = `Failed to call generate post API: ${error.message}`; if (error.response) { // Extract the error message directly from the backend response const backendError = error.response.data?.error || error.response.data?.message; errorMessage = backendError || `Backend API Error (Status ${error.response.status})`; console.error(`${packageName}: Generate post API Error Response:`, error.response.data); } else if (error.request) { errorMessage = "No response received from generate post API."; } console.error(`${packageName}: ${errorMessage}`); sendResponse({ jsonrpc: "2.0", result: { content: [ { type: "text", text: `Failed to generate LinkedIn post: ${errorMessage}` } ], isError: true }, id }); } } else if (name === 'get_linkedin_posts') { - cli.js:1303-1319 (schema)Input schema definition for the 'generate_linkedin_post' tool, returned in the 'tools/list' MCP response. Specifies required 'content' string and optional 'content_type'.
name: "generate_linkedin_post", description: "Generate three LinkedIn post variants from any content (article, newsletter, notes, etc.) to optimize engagement.", inputSchema: { type: "object", properties: { content: { type: "string", description: "The source content to transform into LinkedIn posts. Can be articles, emails, newsletters, notes, etc." }, content_type: { type: "string", description: "Optional. A short description of the content type (e.g., 'article', 'newsletter', 'notes'). Defaults to 'article'." } }, required: ["content"] } }, - cli.js:1181-1375 (registration)The 'tools/list' handler statically registers all available tools including 'generate_linkedin_post' by returning the full list with schemas in the MCP protocol response.
if (method === 'tools/list') { console.error(`${packageName}: Received tools/list request, sending known tool.`); sendResponse({ jsonrpc: "2.0", id: id, result: { tools: [ { name: "publish_linkedin_post", description: "Publish a text post to LinkedIn, optionally including media (images/videos) specified by URL.", inputSchema: { type: "object", properties: { post_text: { type: "string", description: "The text content of the LinkedIn post." }, media: { type: "array", description: "Optional. A list of media items to attach to the post. Each item must have a 'file_url' pointing to a direct image or video URL and a 'filename'.", items: { type: "object", properties: { file_url: { type: "string", description: "A direct URL to the image or video file (e.g., ending in .jpg, .png, .mp4)." }, filename: { type: "string", description: "A filename for the media item (e.g., 'promo_video.mp4')." } }, required: ["file_url", "filename"] } } }, required: ["post_text"] } }, { name: "schedule_linkedin_post", description: "Schedule a text post for LinkedIn at a specific future date and time, optionally including media (images/videos) specified by URL.", inputSchema: { type: "object", properties: { post_text: { type: "string", description: "The text content of the LinkedIn post to be scheduled." }, scheduled_date: { type: "string", description: "The date and time to publish the post, in ISO 8601 format (e.g., '2025-12-31T10:00:00Z' or '2025-12-31T15:30:00+05:30'). Must be in the future." }, media: { type: "array", description: "Optional. A list of media items to attach to the post. Each item must have a 'file_url' pointing to a direct image or video URL and a 'filename'.", items: { type: "object", properties: { file_url: { type: "string", description: "A direct URL to the image or video file (e.g., ending in .jpg, .png, .mp4)." }, filename: { type: "string", description: "A filename for the media item (e.g., 'meeting_notes.mp4')." } }, required: ["file_url", "filename"] } } }, required: ["post_text", "scheduled_date"] } }, { name: "publish_twitter_post", description: "Publish a text post (tweet) to Twitter.", inputSchema: { type: "object", properties: { post_text: { type: "string", description: "The text content of the tweet (maximum 280 characters)." } }, required: ["post_text"] } }, { name: "analyze_linkedin_chat", description: "Ask questions about the user's LinkedIn profile, content, or network, with support for multi-turn conversations.", inputSchema: { type: "object", properties: { query: { type: "string", description: "The question or request about LinkedIn data to be analyzed." }, conversation_history: { type: "array", description: "Optional. Previous messages in the conversation for context. Each message must have 'role' (user/assistant) and 'content' (text).", items: { type: "object", properties: { role: { type: "string", description: "The sender of the message: 'user' or 'assistant'." }, content: { type: "string", description: "The text content of the message." } }, required: ["role", "content"] } } }, required: ["query"] } }, { name: "generate_linkedin_post", description: "Generate three LinkedIn post variants from any content (article, newsletter, notes, etc.) to optimize engagement.", inputSchema: { type: "object", properties: { content: { type: "string", description: "The source content to transform into LinkedIn posts. Can be articles, emails, newsletters, notes, etc." }, content_type: { type: "string", description: "Optional. A short description of the content type (e.g., 'article', 'newsletter', 'notes'). Defaults to 'article'." } }, required: ["content"] } }, { name: "get_linkedin_posts", description: "Retrieve the user's recent LinkedIn posts with engagement metrics.", inputSchema: { type: "object", properties: { limit: { type: "number", description: "Optional. Number of posts to retrieve (1-20). Defaults to 5." } } } }, { name: "get_linkedin_profile", description: "Retrieve the user's LinkedIn profile information including headline, summary, experience, and education.", inputSchema: { type: "object", properties: {} } }, { name: "set_linkedin_url", description: "Set or update the LinkedIn profile URL to analyze. Required before using profile/posts retrieval tools if not set previously.", inputSchema: { type: "object", properties: { linkedin_url: { type: "string", description: "The full LinkedIn profile URL (e.g., https://www.linkedin.com/in/username/)" } }, required: ["linkedin_url"] } }, { name: "refresh_linkedin_profile", description: "Force a refresh of the LinkedIn profile data to update any recent changes.", inputSchema: { type: "object", properties: {} } }, { name: "refresh_linkedin_posts", description: "Force a refresh of LinkedIn posts data to capture recently published content.", inputSchema: { type: "object", properties: {} } } ] } }); return; } else if (method === 'resources/list' || method === 'prompts/list') { - cli.js:15-15 (helper)Configuration constant defining the backend API endpoint URL used by the generate_linkedin_post handler.
const backendGeneratePostApiUrl = 'https://ligo.ertiqah.com/api/mcp/generate-linkedin-post';