Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@b2b-saas-inc/olli-mcp-server show me analytics for last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for olli.social — lets LLMs manage your social presence via API key.
Add to your Claude Desktop (or other MCP client) config:
{
"mcpServers": {
"olli": {
"command": "npx",
"args": ["-y", "@b2b-saas-inc/olli-mcp-server"],
"env": {
"OLLI_API_KEY": "olli_sk_your_key_here"
}
}
}
}Generate an API key in your olli.social profile settings under API Keys.
Related MCP server: @posteahora/mcp
Variable | Required | Default |
| Yes | — |
| No |
|
Category | Tools |
Workspaces |
|
Campaigns |
|
Drafts |
|
Calendar |
|
Assets |
|
ICPs |
|
Industries |
|
Products |
|
Teams |
|
AI |
|
Analytics |
|
Amplification |
|
Leaderboard |
|
Integrations |
|
Notifications |
|
Support |
|
Billing |
|
All workspace-scoped tools require a workspace_id (slug or UUID, e.g. "olli-demo").
npm install
OLLI_API_KEY=olli_sk_... npm run dev
npm run buildMIT
Avatar tool schemas are sourced from olli-social-app's AvatarToolRegistry — the single source of truth for all 34 avatar AI tool definitions. Instead of maintaining duplicate schemas in TypeScript, this MCP server imports them as JSON.
The Rails app exposes GET /api/v1/ai/avatar_schemas (protected by shared secret)
Running npm run sync-schemas fetches the schemas and writes them to src/generated/avatar-schemas.json
At startup, the MCP server reads this JSON file and dynamically registers avatar tools
Each avatar tool proxies execution back to the Rails avatar endpoint
Add these variables to your .env file:
MCP_RAILS_URL=https://api.olli.social
MCP_SHARED_SECRET=your_shared_secret_hereMCP_RAILS_URL is the base URL of your olli-social-app Rails server.MCP_SHARED_SECRET must match the MCP_SHARED_SECRET environment variable on the Rails side.
# Pull latest avatar tool schemas from Rails
npm run sync-schemasThe output file src/generated/avatar-schemas.json is committed to the repo for reproducible builds. Re-run the sync whenever avatar tool definitions change in the Rails app (i.e., when AvatarToolRegistry::SCHEMA_VERSION is bumped).
New avatar tools should be added to AvatarToolRegistry in olli-social-app — never directly in this MCP server. After adding tools in Rails:
Bump SCHEMA_VERSION in avatar_tool_registry.rb
Run npm run sync-schemas in this repo
Commit the updated avatar-schemas.json
Add a user to a team
Inputs: workspace_id (required), team_id (required), user_id (required).
Analyze post content for quality, tone, and suggestions
Inputs: workspace_id (required), content (required), platform.
Approve a pending point redemption request (admin action)
Inputs: workspace_id (required), id (required).
Chat with the AI brand avatar
Inputs: workspace_id (required), message (required), conversation_id.
Generate campaign content (posts, messaging) using AI
Inputs: workspace_id (required), campaign_id (required), platform, count.
Check remaining usage allowance for a feature (e.g., AI generations, posts)
Inputs: workspace_id (required), feature (required).
Add a post to the amplification queue for team sharing
Inputs: workspace_id (required), original_post_id (required), platform (required), content_preview (required), +2 more.
Generate a new API key. The full key value is only shown once in the response.
Inputs: name (required).
Add an asset to the workspace library
Inputs: workspace_id (required), name (required), asset_type (required), url (required), +2 more.
Create a calendar event
Inputs: workspace_id (required), title (required), scheduled_for (required), content, +4 more.
Create a new campaign
Inputs: workspace_id (required), title (required), description, purpose, +13 more.
Create a reusable compose prompt template
Inputs: workspace_id (required), title (required), prompt_text (required), platform, +2 more.
Start domain verification for a workspace (generates DNS/meta tag verification record)
Inputs: workspace_id (required), domain (required).
Create a new draft
Inputs: workspace_id (required), content (required), title, platform, +4 more.
Create an ICP
Inputs: workspace_id (required), name (required), description, criteria.
Create a new incentive reward that team members can redeem with points
Inputs: workspace_id (required), name (required), points_cost (required), description, +1 more.
Create a target industry
Inputs: workspace_id (required), name (required), description, criteria.
Invite a user to the workspace by email
Inputs: workspace_id (required), email (required), role.
Create a new pixel tracking configuration for a website domain
Inputs: workspace_id (required), domain (required), name.
Create a product
Inputs: workspace_id (required), name (required), description, metadata.
Add a new RSS feed for content curation
Inputs: workspace_id (required), url (required), name, category.
Create a support ticket
Inputs: workspace_id (required), subject (required), description (required), priority, +1 more.
Create a new team in a workspace
Inputs: workspace_id (required), name (required), description, metadata.
Add a LinkedIn profile to tracking for prospecting and monitoring
Inputs: workspace_id (required), linkedin_url (required), name, company, +2 more.
Generate multiple variations of a post
Inputs: workspace_id (required), content (required), count, platform.
Add a writing sample to train the AI on your brand voice
Inputs: workspace_id (required), title (required), content (required), platform.
Remove a post from the amplification queue
Inputs: workspace_id (required), id (required).
Revoke and delete an API key
Inputs: id (required).
Delete an asset from the library
Inputs: workspace_id (required), id (required).
Delete a calendar event
Inputs: workspace_id (required), id (required).
Delete a campaign
Inputs: workspace_id (required), id (required).
Delete a compose prompt template
Inputs: workspace_id (required), id (required).
Delete a draft
Inputs: workspace_id (required), id (required).
Delete an ICP
Inputs: workspace_id (required), id (required).
Delete an incentive reward
Inputs: workspace_id (required), id (required).
Delete a target industry
Inputs: workspace_id (required), id (required).
Revoke a pending invitation
Inputs: workspace_id (required), id (required).
Delete a notification
Inputs: workspace_id (required), id (required).
Delete a pixel tracking configuration
Inputs: workspace_id (required), id (required).
Delete a product
Inputs: workspace_id (required), id (required).
Remove an RSS feed from the workspace
Inputs: workspace_id (required), id (required).
Delete a team
Inputs: workspace_id (required), id (required).
Remove a profile from tracking
Inputs: workspace_id (required), id (required).
Remove a writing sample
Inputs: workspace_id (required), id (required).
Disconnect a social platform integration
Inputs: workspace_id (required), platform (required).
Mark a point redemption as fulfilled (reward delivered)
Inputs: workspace_id (required), id (required).
Generate a new Chrome extension connection token for a workspace
Inputs: workspace_id (required).
Generate a social media post using AI
Inputs: workspace_id (required), platform (required), topic (required), tone, +1 more.
Get AI quota usage for the workspace
Inputs: workspace_id (required).
Get details of an amplification post
Inputs: workspace_id (required), id (required).
Get workspace analytics (impressions, engagement, follower growth)
Inputs: workspace_id (required), period.
Get a single asset
Inputs: workspace_id (required), id (required).
Get a single avatar chat conversation with messages
Inputs: workspace_id (required), id (required).
Get billing info and current subscription for a workspace
Inputs: workspace_id (required).
Get a single calendar event
Inputs: workspace_id (required), id (required).
Get a single campaign
Inputs: workspace_id (required), id (required).
Get the onboarding checklist with completion status for each item
Inputs: workspace_id (required).
Check domain verification status
Inputs: workspace_id (required).
Get a single draft
Inputs: workspace_id (required), id (required).
Show the current Chrome extension token for a workspace
Inputs: workspace_id (required).
Get enabled feature flags for a workspace
Inputs: workspace_id (required).
Get details of a specific incentive reward
Inputs: workspace_id (required), id (required).
Get the workspace member leaderboard ranked by content performance
Inputs: workspace_id (required), period, team_id.
Get LinkedIn integration analytics
Inputs: workspace_id (required).
List LinkedIn organizations available for a workspace integration
Inputs: workspace_id (required).
View onboarding progress and completion status for a workspace
Inputs: workspace_id (required).
Get the JavaScript embed snippet for a pixel config (for website installation)
Inputs: workspace_id (required), id (required).
Get features available on the workspace current plan
Inputs: workspace_id (required).
Get the current user profile (display name, email, timezone, etc.)
Inputs: no named parameters.
Get details of a specific RSS feed including sync status
Inputs: workspace_id (required), id (required).
Get details of a support ticket
Inputs: workspace_id (required), id (required).
Get a single team and its members
Inputs: workspace_id (required), id (required).
Get details of a tracked LinkedIn profile including activity history
Inputs: workspace_id (required), id (required).
Get Twitter/X integration analytics
Inputs: workspace_id (required).
Get detailed info about a specific visitor session including page views and identified company
Inputs: workspace_id (required), id (required).
Get aggregated visitor session statistics for a workspace
Inputs: workspace_id (required), since.
Get details of a workspace including subscription and settings
Inputs: workspace_id (required).
Improve existing post content using AI
Inputs: workspace_id (required), content (required), instruction (required), platform.
List amplification posts (posts queued for team amplification). Supports pagination.
Inputs: workspace_id (required), platform, user_id, page, +1 more.
List API keys for the current user
Inputs: no named parameters.
List assets in the workspace library. Supports pagination.
Inputs: workspace_id (required), type, tag, q, +2 more.
List avatar chat conversations. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List calendar events in a workspace. Supports pagination.
Inputs: workspace_id (required), platform, status, start_date, +3 more.
List all campaigns in a workspace. Supports pagination.
Inputs: workspace_id (required), q, status, team_id, +2 more.
List saved compose prompt templates for content generation
Inputs: workspace_id (required), page, per_page.
List drafts in a workspace. Supports pagination.
Inputs: workspace_id (required), platform, q, page, +1 more.
List Ideal Customer Profiles (ICPs) for a workspace. Supports pagination.
Inputs: workspace_id (required), q, page, per_page.
List incentive rewards available for point redemption
Inputs: workspace_id (required), page, per_page.
List target industries for a workspace. Supports pagination.
Inputs: workspace_id (required), q, page, per_page.
List all connected integrations for a workspace
Inputs: workspace_id (required).
List pending invitations for a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List billing invoices for a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List LinkedIn messaging conversations for a workspace
Inputs: workspace_id (required), page, per_page.
List members of a workspace. Supports pagination.
Inputs: workspace_id (required), status, role, page, +1 more.
List notifications for the current user in a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List pixel tracking configurations for website visitor identification
Inputs: workspace_id (required), page, per_page.
List point redemption requests (pending, approved, rejected, fulfilled)
Inputs: workspace_id (required), status, page, per_page.
List products in a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List items/articles from RSS feeds. Filter by feed or browse all.
Inputs: workspace_id (required), feed_id, page, per_page.
List RSS feeds configured for content curation
Inputs: workspace_id (required), page, per_page.
List support tickets for a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List members of a team. Supports pagination.
Inputs: workspace_id (required), team_id (required), page, per_page.
List teams in a workspace. Supports pagination.
Inputs: workspace_id (required), page, per_page.
List messages on a support ticket. Supports pagination.
Inputs: workspace_id (required), ticket_id (required), page, per_page.
List tracked LinkedIn profiles for prospecting and monitoring
Inputs: workspace_id (required), q, page, per_page.
List recent visitor sessions captured by the tracking pixel. Returns company identification, page views, and engagement data.
Inputs: workspace_id (required), since, page, per_page.
List all workspaces the authenticated user belongs to. Supports pagination.
Inputs: page, per_page.
List writing samples that define the workspace brand voice
Inputs: workspace_id (required), page, per_page.
Mark all notifications as read
Inputs: workspace_id (required).
Mark a single notification as read
Inputs: workspace_id (required), id (required).
Publish a draft immediately to a connected social account
Inputs: workspace_id (required), id (required), integration_id (required), author_type.
Reject a pending point redemption request (admin action)
Inputs: workspace_id (required), id (required).
Remove a member from a workspace
Inputs: workspace_id (required), id (required).
Remove a user from a team
Inputs: workspace_id (required), team_id (required), id (required).
Send a reply in a LinkedIn messaging conversation
Inputs: workspace_id (required), conversation_id (required), message (required).
Send a message on a support ticket
Inputs: workspace_id (required), ticket_id (required), body (required).
Request to redeem points for an incentive reward
Inputs: workspace_id (required), incentive_reward_id (required).
Revoke the Chrome extension token for a workspace
Inputs: workspace_id (required).
Schedule a draft for future publishing
Inputs: workspace_id (required), id (required), integration_id (required), scheduled_for (required), +1 more.
Select which LinkedIn company page to post on behalf of
Inputs: workspace_id (required), organization_id (required), organization_name (required), organization_logo_url.
Suggest relevant hashtags for a post
Inputs: workspace_id (required), content (required), platform.
Trigger a LinkedIn data sync for a workspace
Inputs: workspace_id (required).
Manually trigger a sync for an RSS feed to fetch latest items
Inputs: workspace_id (required), id (required).
Trigger a Twitter/X data sync for a workspace
Inputs: workspace_id (required).
Record usage of a feature for quota tracking
Inputs: workspace_id (required), feature (required), quantity.
Update a calendar event
Inputs: workspace_id (required), id (required), title, content, +5 more.
Update an existing campaign
Inputs: workspace_id (required), id (required), title, description, +14 more.
Update a draft
Inputs: workspace_id (required), id (required), title, content, +5 more.
Update an ICP
Inputs: workspace_id (required), id (required), name, description, +1 more.
Update an incentive reward
Inputs: workspace_id (required), id (required), name, description, +2 more.
Update a target industry
Inputs: workspace_id (required), id (required), name, description, +1 more.
Update a workspace membership role or status
Inputs: workspace_id (required), id (required), role, status.
Update a product
Inputs: workspace_id (required), id (required), name, description, +1 more.
Update the current user profile settings
Inputs: display_name, bio, timezone, avatar_url.
Update an RSS feed configuration
Inputs: workspace_id (required), id (required), name, category, +1 more.
Update an existing team
Inputs: workspace_id (required), id (required), name, description, +1 more.
Update workspace settings (name, description, brand voice, etc.)
Inputs: workspace_id (required), name, description, website_url, +2 more.
Trigger domain verification check (after DNS/meta tag has been set up)
Inputs: workspace_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 138 tools
Tools are mostly distinct by resource, but potential overlap between 'create_draft' and 'generate_post' could cause confusion. The large quantity makes subtle distinctions harder.
All tools follow a strict verb_noun snake_case pattern, highly consistent and predictable.
138 tools is far beyond typical scope for a single server. This extreme count suggests lack of focus and may overwhelm agents.
Covers many resources but missing update operations for assets, tracked profiles, pixel configs, etc. Some CRUD gaps exist, but core workflows are generally supported.
Draft, schedule and publish social media posts from any AI agent.
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Draft, schedule and publish social posts to nine platforms from any AI agent.
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
