# Oktopost MCP

> Oktopost connects your AI agent directly to B2B social media data. You get hands-free access to manage campaigns, pull analytics reports, and track leads from LinkedIn, Twitter, and Facebook without opening the dashboard.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** b2b-marketing, employee-advocacy, social-analytics, campaign-management, content-distribution

## Description

You connect your AI agent directly to Oktopost's B2B social media data. You get hands-free access to manage campaigns, pull analytics reports, and track leads from LinkedIn, Twitter, and Facebook without ever having to open the dashboard yourself.

Your agent handles all the heavy lifting, letting you run strategy without logging in. It pulls specific information from every corner of your social presence.

**Campaign Setup and Overview:** You can start by listing every active or archived B2B campaign using `list_campaigns`. Need to check out how a specific campaign was set up? Just ask it to use `get_campaign_details` to pull the exact setup information and settings for that one. The system also lets you retrieve all organization tags used across your campaigns with `list_oktopost_tags`, so you know exactly what categories are being applied.

**Performance Tracking and Analytics:** For hard numbers, your agent pulls reports using `get_analytics_report`. This gives you aggregated performance data points—you can get specific metrics like total clicks or shares for any given period. If you want to see the full history of posts that went out through all campaigns, use `list_social_messages` to pull a complete log of every message, whether it was scheduled or already sent. You can drill down even further; if you know a specific message ID, `get_message_details` pulls the entire content and metadata for just that single post.

**Lead Generation and Conversions:** The system tracks who's interested in your stuff. Your agent generates a list of leads and contacts—the people identified through social media interactions—using `list_social_contacts`. It also keeps tabs on actual goal completion, letting you view all conversions that the platform has attributed to your social activities via `list_social_conversions`.

**Profile Management:** You've got to know what platforms are running. Use `list_social_profiles` to get a list of every single social media profile connected and active with Oktopost. If you need the deep details for one specific account—like all its connection metadata or current status, say for LinkedIn—you call `get_social_profile_details`. 

Basically, your agent gives you full visibility into everything happening on your paid B2B social channels without making you open a browser tab. It pulls the data points so you can focus on what's next.

## Tools

### get_analytics_report
Retrieves a report containing aggregated performance data for your social media campaigns.

### get_campaign_details
Pulls specific setup information and settings for one selected social media campaign.

### get_message_details
Gets the full content and metadata for a single, specific social media message using its ID.

### get_social_profile_details
Retrieves all connection details and current metadata for one of your linked social profiles (e.g., LinkedIn).

### list_campaigns
Lists every active or archived B2B social media campaign set up in Oktopost.

### list_social_contacts
Generates a list of leads and contacts that were identified through social media interactions.

### list_social_conversions
Lists all goal completions and conversions that the system has attributed to your social activities.

### list_social_messages
Provides a history of every message, showing which were scheduled or already sent across campaigns.

### list_social_profiles
Lists all social media profiles that are currently connected and active with Oktopost.

### list_oktopost_tags
Retrieves a list of organization tags used across your campaigns for categorization.

## Prompt Examples

**Prompt:** 
```
List all my active social media campaigns.
```

**Response:** 
```
Retrieving campaigns... I found 8 active campaigns including 'Q1 Product Launch', 'Webinar Promotion', and 'Customer Success Stories'. Would you like to see the scheduled posts for the Product Launch?
```

**Prompt:** 
```
What is the click engagement for the 'Summer Promo' campaign?
```

**Response:** 
```
Fetching analytics... The 'Summer Promo' campaign has generated 450 clicks and 25 shares so far this week. The engagement rate is 3.2%. Shall I list the specific posts that generated the most traffic?
```

**Prompt:** 
```
Show me the latest leads identified from LinkedIn.
```

**Response:** 
```
Retrieving social contacts... I found 5 new leads identified from LinkedIn engagements today. Notable contacts include 'Sarah Miller (Marketing Director)' and 'David Chen (CTO)'. Would you like their profile details and engagement history?
```

## Capabilities

### Retrieve detailed performance metrics
The agent fetches aggregated reports, giving you specific data points like total clicks or shares for a selected period.

### List and inspect social campaigns
You can list all current campaigns using `list_campaigns` and then pull detailed settings for any single campaign using `get_campaign_details`.

### Track leads and conversions from social activity
The server gathers a list of new contacts (`list_social_contacts`) or records how many goals were hit due to your social posts (`list_social_conversions`).

### Monitor all scheduled and sent messages
You can pull a complete log of every message—both drafted and published—across all campaigns using `list_social_messages`.

### Check connected profile statuses
Use `list_social_profiles` to get the metadata and connection status for every social platform linked to your Oktopost account.

## Use Cases

### The Quarterly Performance Review
A Marketing Analyst needs to prove ROI for the last quarter. Instead of manually exporting reports from LinkedIn, Twitter, and Facebook, they ask their agent to run `get_analytics_report` combined with `list_social_conversions`. The agent consolidates click counts and goal completions, giving them a single, unified report immediately.

### The Lead Follow-Up Crisis
A Demand Generation Specialist spots high activity on LinkedIn but can't remember which leads responded. They ask the agent to run `list_social_contacts`. The server returns a list of 5 new contacts, including their job titles and engagement history, allowing them to follow up instantly.

### Pre-launch Content Audit
A Social Media Manager is launching a big campaign. They use `list_campaigns` to check the status of all related efforts, then run `get_campaign_details` on the primary account to confirm the correct budget and profile links are in place before posting anything.

### Checking Message History Compliance
A compliance officer needs proof that certain messages were never sent. They ask the agent to run `list_social_messages` for a specific date range, getting a complete log of every message and its content for review.

## Benefits

- **Get instant performance metrics.** Instead of navigating to the analytics tab, ask your agent for `get_analytics_report` and get actionable data points in seconds.
- **Manage leads without clicking.** Need to know who responded on LinkedIn? Use `list_social_contacts` to pull a fresh list of qualified leads directly into your chat session.
- **See campaign status instantly.** Before drafting content, run `list_campaigns` to confirm if the 'Q3 Launch' campaign is still active or if it needs archiving.
- **Audit every post.** Use `list_social_messages` to review a comprehensive log of scheduled and sent messages across all platforms. No more guessing what went out last week.
- **Validate connections easily.** Run `list_social_profiles` first to ensure your agent has access to all necessary accounts before attempting any major data pull.

## How It Works

The bottom line is: your agent acts as a natural language wrapper around complex social media APIs, giving you immediate access to B2B marketing data.

1. Subscribe to this server, then provide your unique Oktopost Account ID and API Key.
2. Your AI client (Claude, Cursor, etc.) uses the provided credentials to query the Oktopost API.
3. The agent executes the necessary tool calls—like `list_campaigns` or `get_analytics_report`—and returns structured data for you to read.

## Frequently Asked Questions

**How do I check if my social media accounts are connected using list_social_profiles?**
Running `list_social_profiles` shows all linked platforms and their current connection status. This is the first step to ensure your agent can access metadata for any subsequent tools.

**What should I use to get performance data? Is it list_campaigns or get_analytics_report?**
Use `get_analytics_report`. While `list_campaigns` shows existence and status, the report tool pulls the actual metrics like clicks and shares you need for analysis.

**Can I find out who generated leads using list_social_contacts?**
Yes. The `list_social_contacts` tool retrieves a dedicated roster of leads identified through social media engagement, giving you names and roles directly in the chat.

**How do I see all my past posts using list_social_messages?**
The `list_social_messages` tool provides a complete historical log. It shows which messages were scheduled, which ones went out, and their specific content.

**How do I get all the settings and details for a specific campaign using get_campaign_details?**
It retrieves every setting associated with that campaign. You'll get deep info like start/end dates, assigned goals, and budget parameters—not just a summary.

**What does get_social_profile_details provide besides connection status?**
This tool pulls the complete metadata for any linked profile. You can check things like the full account name, user ID, and specific platform settings that aren't visible elsewhere.

**Is list_social_conversions better than get_analytics_report for tracking goals?**
list_social_conversions focuses specifically on successful goal completions. While analytics report handles raw metrics like clicks, this lists records of confirmed conversions.

**How do I see what tags are available in my account using list_oktopost_tags?**
It provides a complete list of all organization tags. This helps you understand the current taxonomy and group your content efforts correctly within Oktopost.

**How do I find my Oktopost API credentials?**
Log in to your Oktopost account and navigate to App Settings > API to find your Account ID and generate an API Key.

**Can I see leads generated from social media?**
Yes! Use the `list_social_contacts` tool to retrieve a list of individuals who have engaged with your posts and been identified as leads.

**Does this support LinkedIn and Twitter?**
Yes, Oktopost supports major B2B social platforms. Use `list_social_profiles` to see all your connected accounts and their statuses.