Oktopost

MCP Server

Connect AI assistants and automation tools to Oktopost through the Model Context Protocol integration.

The Oktopost MCP Server provides a comprehensive integration layer that enables AI assistants like Claude and ChatGPT, along with automation platforms, to interact directly with your Oktopost account. Through the Model Context Protocol, you can create campaigns, schedule posts, manage approvals, and streamline social media operations using natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely access external systems and data. The Oktopost MCP Server implements this protocol, giving AI tools structured access to your Oktopost workspace while respecting your permissions and access controls.

Supported Platforms

The MCP Server works with multiple platforms through different authentication methods:

  • Claude Desktop - Local configuration with API keys
  • ChatGPT - OAuth-based cloud integration
  • Claude (Web) - OAuth-based cloud integration
  • Automation Tools - n8n, Make, and other platforms via Basic Auth

Available Capabilities

Campaign Management

Create and manage campaigns to organize your social media content.

  • create_campaign - Create a new campaign with name, URL, and tags
  • get_campaign_by_id - Retrieve campaign details by ID
  • list_campaigns - List campaigns with optional filters

Content Creation

Build and manage reusable content assets for your social posts.

  • create_message - Create a message with links or media attachments
  • get_message_by_id - Retrieve message details by ID
  • list_messages - List messages by campaign or message IDs

Post Publishing

Schedule and manage posts across your connected social networks.

  • create_post - Create a social post, optionally sending to approval workflow
  • update_post - Modify an unsent post
  • get_post - Retrieve post details with optional analytics
  • list_social_posts - List social posts by ID
  • get_social_post - Get a single post with optional performance stats

Media Management

Upload and organize images, videos, and other media assets.

  • create_media - Create a media asset from a public image URL
  • list_media - List media assets with optional filters
  • get_media - Retrieve media details by ID
  • create_upload - Create a media upload request from a public URL
  • list_uploads - List uploads with filters
  • get_upload - Get upload details by ID

Calendar & Planning

View and manage your content calendar.

  • get_calendar - Retrieve calendar data with optional date and profile filters

Social Profiles

Access your connected social media accounts.

  • list_social_profiles - List all connected social profiles
  • get_social_profile - Get details for a specific profile by ID

Approval Workflows

Manage content approval processes and add review notes.

  • list_workflows - List all approval workflows and their steps
  • list_workflow_items - View messages and posts pending approval
  • process_workflow_item - Approve or reject an item with optional notes
  • list_workflow_item_notes - List review notes for a post or message
  • add_workflow_item_note - Add a review note to workflow items

Employee Advocacy

Manage your advocacy boards, topics, and stories.

  • list_boards - List all advocacy boards
  • list_board_topics - List topics for organizing advocacy content
  • create_board_topic - Create a new board topic
  • list_board_stories - List stories in a board
  • create_board_story - Create a new advocacy story
  • update_board_story - Update an existing story

User Management

Access user information and permissions.

  • list_users - List users with basic information
  • get_user - Get detailed information for a specific user

Feedback

Share feedback directly from your AI assistant.

  • send_feedback - Send bug reports or feature requests to Oktopost

Setup & Authentication

The MCP Server supports multiple authentication methods depending on how you're connecting.

Claude Desktop (Local Setup)

Connect Claude Desktop to your Oktopost account using local configuration with API credentials.

Prerequisites

  • Node.js v20 or higher installed on your machine
  • Your Oktopost Account ID
  • Your Oktopost API Key (from My Profile)
  • Your Account Region (US or EU)

Configuration Steps

  1. Open Claude Desktop and go to Settings → Developer
  2. Click Edit Config to open claude_desktop_config.json
  3. Add the Oktopost MCP Server configuration:
{
  "mcpServers": {
    "oktopost": {
      "command": "npx",
      "args": ["oktopost-mcp"],
      "env": {
        "OKTOPOST_ACCOUNT_REGION": "us",
        "OKTOPOST_ACCOUNT_ID": "your_account_id_here",
        "OKTOPOST_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. Save the file and restart Claude Desktop
  2. The Oktopost tools will now be available in your conversations

Replace your_account_id_here and your_api_key_here with your actual credentials. Set OKTOPOST_ACCOUNT_REGION to us or eu based on your account's data center.

ChatGPT & Claude Web (OAuth)

Cloud-based AI assistants connect via OAuth for secure, permission-aware access.

Authorization Flow

  1. Navigate to the MCP integrations section in ChatGPT or Claude
  2. Search for "Oktopost" and click Connect
  3. You'll be redirected to Oktopost to approve the connection
  4. Review the requested permissions and click Authorize
  5. You'll be redirected back to your AI assistant with access enabled

The OAuth flow ensures the MCP Server only has access to resources permitted by your Oktopost role and permissions.

Automation Platforms (Basic Auth)

Connect automation tools like n8n, Make, or custom scripts using Basic HTTP Authentication.

Connection Details

  • Endpoint: https://mcp.oktopost.com
  • Authentication Method: Basic Auth
  • Username: Your Oktopost Account ID
  • Password: Your Oktopost API Key

Example Configuration (n8n)

  1. Add an HTTP Request node
  2. Set the URL to https://mcp.oktopost.com/tools/{tool_name}
  3. Under Authentication, select Basic Auth
  4. Enter your Account ID as the username
  5. Enter your API Key as the password

Keep your API credentials secure. Never commit them to version control or share them publicly. Use environment variables or secure credential management systems.

Use Cases

Content Creation with AI

Ask Claude or ChatGPT to help you:

  • Draft social posts for multiple networks
  • Create campaigns and organize content
  • Schedule posts to your calendar
  • Upload and attach media to posts

Example: "Create a LinkedIn post about our new product launch, schedule it for tomorrow at 10am, and attach the product image from our media library."

Approval Workflow Management

Use AI to streamline your approval process:

  • Review pending posts and messages
  • Approve or reject items with feedback
  • Add review notes for your team
  • Check workflow status

Example: "Show me all posts pending approval, then approve the LinkedIn post about the webinar and add a note suggesting we include registration numbers."

Employee Advocacy

Manage your advocacy program through conversation:

  • Create and organize board stories
  • Add topics for content categorization
  • Update story details and messaging
  • Review board performance

Example: "Create a new advocacy story about our latest case study, add it to the 'Customer Success' topic, and include messages for LinkedIn and Twitter."

Analytics & Reporting

Query your social performance data:

  • Get post analytics and engagement metrics
  • Review calendar schedules
  • Check profile performance
  • Monitor campaign results

Example: "Show me the analytics for our posts from last week and tell me which one performed best."

Security & Permissions

Permission-Aware Access

The MCP Server respects your Oktopost permissions:

  • Users can only access resources they have permissions for
  • API actions are subject to the same role-based access controls as the Oktopost platform
  • OAuth connections are limited to explicitly approved scopes

Data Privacy

  • All communication uses HTTPS encryption
  • API credentials are never logged or stored by the MCP Server
  • OAuth tokens can be revoked at any time from your Oktopost account settings

Best Practices

  1. Use the minimum required permissions - Only grant access to tools you need
  2. Rotate API keys regularly - Generate new keys periodically for enhanced security
  3. Monitor usage - Review API activity in your Oktopost account
  4. Revoke unused connections - Remove OAuth connections you no longer use

Troubleshooting

Connection Issues

Problem: Claude Desktop doesn't show Oktopost tools

Solution:

  • Verify your claude_desktop_config.json is saved correctly
  • Restart Claude Desktop completely
  • Check that Node.js v20+ is installed: node --version
  • Verify your credentials are correct

Problem: "Authentication failed" errors

Solution:

  • Confirm your Account ID and API Key are correct
  • Check that your API Key hasn't expired
  • Verify the region matches your account (US vs EU)

Permission Errors

Problem: "403 Forbidden" or "Permission denied" responses

Solution:

  • Verify your Oktopost user role has access to the requested resource
  • Check that you have the necessary permissions in your account settings
  • Contact your Oktopost administrator to request additional permissions

OAuth Issues

Problem: OAuth authorization fails or loops

Solution:

  • Clear your browser cookies and try again
  • Use an incognito/private browsing window
  • Verify you're logged into the correct Oktopost account
  • Check if your organization has SSO requirements

Support

Getting Help

If you encounter issues or have questions:

  1. Check the Documentation - Review this guide and the API Reference
  2. Search Issues - Check GitHub Issues for similar problems
  3. Contact Support - Email help@oktopost.com for assistance

Reporting Bugs

Found a bug? Help us improve by:

  1. Opening a GitHub Issue
  2. Including your setup details (platform, authentication method)
  3. Providing steps to reproduce the issue
  4. Sharing any error messages (with credentials redacted)

You can also use the send_feedback tool directly from your AI assistant to report issues.

Resources

License

The Oktopost MCP Server is provided under the Apache License 2.0.

Oktopost customers may use this implementation in accordance with the Oktopost platform's Terms and Conditions. Developers are free to review the source code, modify it, and build their own MCP Server implementations for Oktopost, subject to the Apache 2.0 license terms.

Next Steps

Ready to get started? Here's what to do next:

  1. Choose your platform - Decide if you'll use Claude Desktop, ChatGPT, or an automation tool
  2. Set up authentication - Follow the setup instructions for your chosen platform
  3. Test the connection - Try a simple command like listing campaigns
  4. Explore capabilities - Experiment with different tools and use cases
  5. Integrate into workflows - Build AI-powered social media workflows

For technical questions or partnership inquiries, contact our team at help@oktopost.com.

Webhooks

Subscribe to real-time events in your Oktopost account and receive instant notifications via HTTP callbacks.

Conversions

Track valuable user actions like form submissions and downloads by sending conversion events directly from the browser.

On this page

What is MCP?Supported PlatformsAvailable CapabilitiesCampaign ManagementContent CreationPost PublishingMedia ManagementCalendar & PlanningSocial ProfilesApproval WorkflowsEmployee AdvocacyUser ManagementFeedbackSetup & AuthenticationClaude Desktop (Local Setup)PrerequisitesConfiguration StepsChatGPT & Claude Web (OAuth)Authorization FlowAutomation Platforms (Basic Auth)Connection DetailsExample Configuration (n8n)Use CasesContent Creation with AIApproval Workflow ManagementEmployee AdvocacyAnalytics & ReportingSecurity & PermissionsPermission-Aware AccessData PrivacyBest PracticesTroubleshootingConnection IssuesPermission ErrorsOAuth IssuesSupportGetting HelpReporting BugsResourcesLicenseNext Steps