> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Content Publishing

> Learn how to implement AI chatbots that can help users publish and schedule content across multiple social media platforms using the MCP server.

# Content Publishing & Scheduling

This example demonstrates a simple workflow to publish and schedule content to social media platforms using the MCP server.

## Basic Workflow

<CodeGroup>
  ```text Simple Example theme={null}
  User: List all my users

  AI: [Calls get-users-by-tenant-app]
  Here are all your users:

  1. John Smith (john.smith@example.com)
     - ID: user-123-abc-456-def
     - Created: January 15, 2025

  2. Sarah Johnson (sarah.j@example.com)
     - ID: user-789-ghi-101-jkl
     - Created: February 3, 2025

  User: List all user accounts Sarah Johnson have

  AI: [Calls get-user-accounts with user_id]
  Sarah Johnson (sarah.j@example.com) has the following user accounts:

  1. Instagram
     - ID: acct-456-insta-789
     - Platform Account ID: 123456789012345
     - Last refreshed: May 10, 2025
     - Status: Active

  User: Show me profile details

  AI: [Calls fetch-profiles with user_account_id]
  Here are the profile details for Sarah's Instagram account:

  Profile Information:
  - Username: sarah_johnson_official
  - Display Name: Sarah Johnson
  - Platform: Instagram
  - URL: https://www.instagram.com/sarah_johnson_official
  - Description: Digital marketing specialist | Photography enthusiast

  Statistics:
  - Followers: 2,450
  - Following: 856
  - Content Count: 128
  - Joined: January 2025

  User: Publish a new post to this account with this image https://example.com/scenic-view.jpg and title "Morning views are the best views"

  AI: [Calls publish-content with required parameters]
  Content successfully published to the Instagram account!

  Details:
  - Type: Instagram Post
  - Format: Image
  - Title: Morning views are the best views
  - Media: Scenic view image
  - Visibility: Public
  - Job ID: job-123-456-789

  User: Now schedule a post to be published tomorrow at 9 AM with the image https://example.com/product-launch.jpg and quote in the title

  AI: [Calls publish-content with scheduled_for parameter]
  I've successfully scheduled a post for Sarah's Instagram account.

  Post Details:
  - Type: Instagram Post
  - Format: Image
  - Title: "Success is not final, failure is not fatal: it is the courage to continue that counts." - Winston Churchill
  - Scheduled for: Tomorrow at 09:00 AM
  - Job ID: job-987-654-321

  The post has been scheduled successfully and will automatically go live at the scheduled time.
  ```
</CodeGroup>

## Implementation Steps

To implement content publishing functionality, follow these simple steps:

1. **Get Users**: Use `get-users-by-tenant-app` to retrieve all users

2. **Get User Accounts**: Use `get-user-accounts` with the selected user's ID to retrieve their connected social media accounts

3. **View Profile Details** (Optional): Use `fetch-profiles` with the account ID to get profile information

4. **Publish Content**: Use `publish-content` with the account ID, content type, format, media URL, and title to post immediately

5. **Schedule Content**: Use `publish-content` with the additional `scheduled_for` parameter to schedule posts for the future (must be at least 10 minutes ahead)

## Content Types and Formats

When publishing content, specify the appropriate type and format:

| Platform  | Content Type     | Available Formats  |
| --------- | ---------------- | ------------------ |
| Instagram | INSTAGRAM\_POST  | IMAGE, VIDEO       |
| Instagram | INSTAGRAM\_STORY | IMAGE, VIDEO       |
| Instagram | INSTAGRAM\_REEL  | VIDEO              |
| Facebook  | FACEBOOK\_POST   | IMAGE, VIDEO, TEXT |
| Facebook  | FACEBOOK\_STORY  | IMAGE, VIDEO       |
| Facebook  | FACEBOOK\_REEL   | VIDEO              |
| LinkedIn  | LINKEDIN\_POST   | IMAGE, VIDEO, TEXT |
| Twitter/X | X\_POST          | IMAGE, VIDEO, TEXT |
| TikTok    | TIKTOK\_VIDEO    | VIDEO              |
| YouTube   | YOUTUBE\_VIDEO   | VIDEO              |
| YouTube   | YOUTUBE\_SHORT   | VIDEO              |

## Required MCP Tools

This implementation uses these tools:

* `get-users-by-tenant-app` - Lists all users
* `get-user-accounts` - Lists user's social media accounts
* `fetch-profiles` - Gets detailed profile information
* `publish-content` - Publishes or schedules content to social platforms

## Prompt Engineering Tips

When designing prompts for your AI assistant to handle content publishing requests, consider:

1. **Multi-turn conversations** - Break down the content creation process into steps
2. **Platform-specific guidance** - Suggest optimal content formats for each platform
3. **Preview capabilities** - Allow users to visualize how posts will appear before publishing
4. **Scheduling options** - Support both immediate posting and future scheduling
5. **Error handling** - Provide clear feedback if there are issues with publishing

## Advanced Features

To enhance this capability, consider implementing:

* **Content optimization suggestions** - Recommend hashtags, image sizes, or text length adjustments
* **Cross-platform content adaptation** - Automatically adjust content to match platform-specific requirements
* **Engagement time optimization** - Suggest optimal posting times based on audience engagement patterns
* **Content series scheduling** - Allow users to schedule multiple related posts as a campaign
* **Draft saving** - Let users save content ideas as drafts for later refinement and posting