Oktopost

You can integrate with Oktopost programmatically through a dedicated MCP Server that exposes campaigns, messages, posts, media, calendars, workflows, advocacy boards, and user data. This server lets you create, manage, and schedule content, handle approvals, and automate day-to-day social operations from your MCP clients in a secure, structured way.

How to use

Connect your MCP client to the Oktopost MCP Server to access the full set of capabilities. You can use a local, stdio-based server configuration for development and testing, or use OAuth with supported clients like ChatGPT and Claude for cloud-based interactions. Automation platforms can connect via Basic HTTP Authentication for programmatic access.

How to install

Prerequisites: install Node.js v20 or higher on your machine.

Create a local MCP server configuration for the Oktopost MCP Server using the following snippet. This config enables a stdio-based runtime via npx and provides the required environment variables for your Oktopost account.

{
  "mcpServers": {
    "oktopost": {
      "command": "npx",
      "args": ["oktopost-mcp"],
      "env": {
        "OKTOPOST_ACCOUNT_REGION": "us",
        "OKTOPOST_ACCOUNT_ID": "your_oktopost_account_id",
        "OKTOPOST_API_KEY": "your_oktopost_api_key"
      }
    }
  }
}

To connect a desktop MCP client (example shown for Claude Desktop) you would place the above configuration into your client’s MCP settings. Then restart the client to load the new server.

Additional configuration and usage notes

Authentication can be handled in multiple ways depending on your client. Desktop and local setups use environment-based configuration. Cloud-based clients (ChatGPT, Claude) use OAuth with user-consented scopes. Automation tools can connect using Basic HTTP Authentication with your Oktopost Account ID as the username and your API token as the password.

Environment variables shown here should be kept secure and not checked into source control. Replace the placeholders with your actual values before connecting.

Tools and capabilities

The Oktopost MCP Server exposes a comprehensive set of endpoints to manage your social operations. Here are the core capabilities you can leverage from MCP clients:

• Campaigns: create campaigns, retrieve by ID, list with filters
• Messages: create messages, retrieve by ID, list by campaign or IDs
• Posts: create and update posts, fetch with analytics, list and retrieve individual posts
• Media & Uploads: create media from public URLs, list, retrieve, and create upload requests
• Calendar & Planning: retrieve calendar data with filters
• Social Profiles: list and retrieve connected profiles
• Approvals: list workflows, approve/reject items, manage notes
• Employee Advocacy: list boards/topics, create topics and stories, update stories
• Users: list and retrieve user information
• Feedback: send bug reports or feature requests

If you need to extend capabilities, you can interact with the same MCP endpoints through your client application, using the standard authentication flow and respecting roles and permissions.

Security and access

All methods authenticate against the Oktopost REST API and respect user roles, permissions, and asset-level access. Use least-privilege access tokens and rotate credentials regularly. For desktop setups, keep environment variables secure on your host machine.

Troubleshooting

If you encounter connection or authentication issues, verify that your environment variables are correctly set and that the MCP server command is available in your PATH. Check that the Account ID, Region, and API Key are correct. For OAuth-based clients, ensure you completed the authorization flow and granted the requested scopes.

Notes

This setup uses an MCP JSON configuration to run the local stdio server with the npx command and the oktopost-mcp package. Replace placeholder values with your real account details before connecting any MCP client.

Examples

{
  "mcpServers": {
    "oktopost": {
      "command": "npx",
      "args": ["oktopost-mcp"],
      "env": {
        "OKTOPOST_ACCOUNT_REGION": "us",
        "OKTOPOST_ACCOUNT_ID": "your_oktopost_account_id",
        "OKTOPOST_API_KEY": "your_oktopost_api_key"
      }
    }
  }
}

Available tools

create_campaign

Create a new campaign with name, URL, and tags.

get_campaign_by_id

Retrieve a campaign by its ID.

list_campaigns

List campaigns with optional filters.

create_message

Create a new message with a link or media attachments.

get_message_by_id

Get message data by ID.

list_messages

List messages by campaign or message IDs.

create_post

Create a social post, with optional workflow submission.

update_post

Update an unsent post.

get_post

Retrieve a post by ID, optionally with analytics.

list_social_posts

List social posts by post ID.

get_social_post

Get a single social post with optional stats.

create_media

Create a media asset from a public image URL.

list_media

List media assets with optional filters.

get_media

Get media by ID.

create_upload

Create a media upload request from a public URL.

list_uploads

List uploads with filters.

get_upload

Get an upload by ID.

get_calendar

Retrieve calendar data with optional filters.

list_social_profiles

List connected social profiles.

get_social_profile

Get a single social profile by ID.

list_workflows

List all workflows and their steps.

list_workflow_items

List messages and posts pending approval.

process_workflow_item

Approve or reject an item with an optional note.

list_workflow_item_notes

List workflow notes for a post or message.

add_workflow_item_note

Add a workflow note for a post or message.

list_boards

List all advocacy boards.

list_board_topics

List topics for advocacy boards.

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 advocacy story.

list_users

List users with basic info.

get_user

Get detailed information for a specific user.

send_feedback

Send bug reports or feature requests.