MCP Art Supply Store

Instructions

Implementation Reference

• src/index.ts:1086-1139 (handler)

  Handler function for 'post_to_social_media' tool. Checks configuration, parses input, calls appropriate platform posters (Facebook/Instagram), collects results, and returns formatted response with success/failure status.
  case 'post_to_social_media': { if (!socialMediaManager.isConfigured()) { return { content: [{ type: 'text', text: `⚠️ Social media not configured yet!\n\nTo use this feature:\n1. Create a Facebook Business account\n2. Create a Facebook App\n3. Get your access tokens\n4. Add them to your .env file\n\nSee FACEBOOK_INSTAGRAM_SETUP.md for detailed instructions.` }] }; } const platforms = String(args?.platforms || 'facebook').toLowerCase().split(',').map(p => p.trim()); const message = String(args?.message || ''); const imageUrl = args?.imageUrl ? String(args.imageUrl) : undefined; const hashtags = args?.hashtags ? String(args.hashtags).split(',').map(h => h.trim()) : undefined; const scheduleTime = args?.scheduleTime ? String(args.scheduleTime) : undefined; const results = []; for (const platform of platforms) { if (platform === 'facebook' || platform === 'both') { const result = await socialMediaManager.postToFacebook({ platform: 'facebook', message, imageUrl, scheduledTime: scheduleTime }); results.push(result); } if (platform === 'instagram' || platform === 'both') { const result = await socialMediaManager.postToInstagram({ platform: 'instagram', message, imageUrl, hashtags }); results.push(result); } } const successCount = results.filter(r => r.success).length; const failedResults = results.filter(r => !r.success); return { content: [{ type: 'text', text: `📱 Social Media Post Results\n\n✅ ${successCount}/${results.length} successful\n\n${results.map(r => r.success ? `✓ ${r.platform}: Posted${r.scheduledTime ? ` (scheduled for ${r.scheduledTime})` : ''}\n Post ID: ${r.postId}` : `✗ ${r.platform}: Failed - ${r.error}` ).join('\n\n')}${failedResults.length > 0 ? '\n\n💡 Tip: Check your API tokens and permissions if posts failed.' : ''}` }] }; }
• src/index.ts:362-375 (schema)

  Tool schema definition including name, description, and inputSchema for validation in MCP server.
  name: 'post_to_social_media', description: 'Post content to Facebook and/or Instagram. Requires Meta API configuration. Can schedule posts for future publishing.', inputSchema: { type: 'object', properties: { platforms: { type: 'string', description: 'Comma-separated platforms: facebook, instagram, or both' }, message: { type: 'string', description: 'Post caption/message' }, imageUrl: { type: 'string', description: 'Optional: URL to image (required for Instagram)' }, hashtags: { type: 'string', description: 'Optional: Comma-separated hashtags (without # symbol)' }, scheduleTime: { type: 'string', description: 'Optional: Schedule for future (YYYY-MM-DD HH:MM format)' }, }, required: ['platforms', 'message'], }, },
• src/index.ts:516-518 (registration)

  Registration of tool list handler, which returns the full tools array including 'post_to_social_media'.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });
• src/social-media.ts:76-131 (helper)

  postToFacebook helper method: Posts to Facebook Graph API, handles scheduling, returns post result or error.
  async postToFacebook(post: SocialPost): Promise<PostResult> { if (!this.isConfigured()) { return { success: false, platform: 'facebook', error: 'Facebook API not configured. Please set FB_PAGE_TOKEN and FB_PAGE_ID environment variables.' }; } try { const url = `https://graph.facebook.com/${this.apiVersion}/${this.fbPageId}/feed`; const body: any = { message: post.message, access_token: this.fbPageToken, }; if (post.link) { body.link = post.link; } if (post.scheduledTime) { body.published = false; body.scheduled_publish_time = Math.floor(new Date(post.scheduledTime).getTime() / 1000); } const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }); const result = await response.json() as any; if (result.error) { return { success: false, platform: 'facebook', error: result.error.message }; } return { success: true, postId: result.id, platform: 'facebook', scheduledTime: post.scheduledTime }; } catch (error: any) { return { success: false, platform: 'facebook', error: error.message }; } }
• src/social-media.ts:136-222 (helper)

  postToInstagram helper method: Creates media container then publishes via Instagram Graph API, handles hashtags and images, returns post result or error.
  async postToInstagram(post: SocialPost): Promise<PostResult> { if (!this.isConfigured() || !this.igAccountId) { return { success: false, platform: 'instagram', error: 'Instagram API not configured. Please set IG_ACCOUNT_ID environment variable.' }; } if (!post.imageUrl) { return { success: false, platform: 'instagram', error: 'Instagram posts require an image. Please provide imageUrl.' }; } try { // Step 1: Create media container const containerUrl = `https://graph.facebook.com/${this.apiVersion}/${this.igAccountId}/media`; let caption = post.message; if (post.hashtags && post.hashtags.length > 0) { caption += '\n\n' + post.hashtags.map(tag => tag.startsWith('#') ? tag : `#${tag}`).join(' '); } const containerBody: any = { image_url: post.imageUrl, caption: caption, access_token: this.fbPageToken }; const containerResponse = await fetch(containerUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(containerBody) }); const containerResult = await containerResponse.json() as any; if (containerResult.error) { return { success: false, platform: 'instagram', error: containerResult.error.message }; } const containerId = containerResult.id; // Step 2: Publish container const publishUrl = `https://graph.facebook.com/${this.apiVersion}/${this.igAccountId}/media_publish`; const publishBody = { creation_id: containerId, access_token: this.fbPageToken }; const publishResponse = await fetch(publishUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(publishBody) }); const publishResult = await publishResponse.json() as any; if (publishResult.error) { return { success: false, platform: 'instagram', error: publishResult.error.message }; } return { success: true, postId: publishResult.id, platform: 'instagram' }; } catch (error: any) { return { success: false, platform: 'instagram', error: error.message }; } }