WoopSocial MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with WoopSocial MCP or direct API to publish social posts, schedule campaigns, manage media, and monitor webhooks through natural language.

WoopSocial logoWoopSocial
Api Key

WoopSocial is a social media management API for publishing, scheduling, media, projects, accounts, and webhooks. It helps teams manage social workflows from one programmable platform.

20 Tools

Try WoopSocial now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
WoopSocial
Try asking
TOOLS

Supported Tools

Every WoopSocial action and event your agent gets out of the box.

Create Draft Post

Save a post as a WoopSocial draft without publishing it externally.

Create Project

Create a WoopSocial project in the API key's organization.

Delete Media

Permanently delete one WoopSocial media-library item by its exact, explicitly supplied media ID.

Delete Post

Permanently delete a parent post by its exact ID.

Delete Project

Permanently delete a WoopSocial project by an exact, explicitly supplied project ID.

Delete Social Account

Permanently remove a connected social account from WoopSocial using its exact ID.

Delete Social Account Post

Permanently delete one social-account-specific post delivery using its exact delivery ID.

Delete Webhook

Permanently delete one WoopSocial webhook endpoint using its exact, explicitly supplied webhook ID.

Get Post

Get a parent post and its per-social-account delivery records by post ID.

Get Social Account Platform Inputs

Get dynamic Pinterest board choices or TikTok posting-policy options for a connected social account before constructing a post target.

List Media

List one page of WoopSocial media-library items, optionally filtered by project or exact media IDs.

List Projects

List all projects accessible to the connected WoopSocial API key.

List Social Account Posts

List one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses.

List Social Accounts

List connected social accounts available for publishing, optionally within one project.

List Webhooks

List registered WoopSocial webhook endpoints and their subscribed events.

Publish Post Now

Publish a post to external social platforms now; external publication is an irreversible action.

Register Webhook

Register a public HTTPS endpoint for WoopSocial publishing-success and/or publishing-failure events.

Schedule Post

Schedule automatic future publication to external social platforms; that future publication is irreversible.

Upload Media

Upload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint.

Validate Post

Validate a proposed WoopSocial post without creating it.

SETUP GUIDE

Connect WoopSocial MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for WoopSocial
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List my WoopSocial projects and connected social accounts'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect WoopSocial API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute WoopSocial Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List my WoopSocial projects and connected social accounts'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute WoopSocial actions with your Agent

Why Use Composio?

AI Native WoopSocial Integration

  • Supports both WoopSocial MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable social publishing and scheduling
  • Rich coverage for posts, media, projects, accounts, and webhook workflows

Managed Auth

  • Secure API key handling without hard-coding WoopSocial credentials in your agent code
  • Central place to manage, scope, and revoke WoopSocial access
  • Per user and per environment credentials so teams can ship safely

Agent Optimized Design

  • Tools are tuned for AI agents, so publishing, scheduling, and media actions are easier to call correctly
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access WoopSocial
  • Scoped, least privilege access to WoopSocial resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, WoopSocial requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with WoopSocial.It takes 30 seconds.

Managed auth, hosted MCP servers, and every WoopSocial tool your agent needs.Free to start.

Start building