Kabon Share API
    • Overview
    • MCP
    • Platforms
      • Bluesky
      • Instagram
      • Tiktok
      • Linkedin
      • Youtube
      • Facebook
      • Threads
      • Twitter
    • User Auth
      • Sign up
        POST
      • Verify email OTP
        POST
      • Resend OTP
        POST
      • Login with email & password
        POST
      • Sign in / sign up with Google
        POST
      • Request password reset email
        POST
      • Reset password with token
        POST
      • Refresh JWT token
        POST
    • Users
      • Get current user profile
        GET
      • Update current user profile
        PATCH
      • Get all user settings
        GET
      • Update publishing settings
        PATCH
      • Update notification settings
        PATCH
      • Update UI preferences
        PATCH
      • Get current billing usage
        GET
      • List saved payment methods
        GET
      • List billing transactions
        GET
      • Regenerate API key
        POST
      • Mark onboarding complete
        PATCH
      • Create a new user and get API key
        POST
      • Unregister a device from push notifications
        DELETE
      • Get list of registered devices
        GET
      • Register a device for push notifications
        POST
      • Send a test push notification to the current user
        POST
      • Remove the profile picture
        DELETE
      • Upload a profile picture. Stored in the avatars folder, served via the
        POST
      • Delete a payment method
        DELETE
      • Set a payment method as default
        PATCH
      • Download the invoice/receipt PDF for a captured (succeeded) transaction
        GET
    • Social Accounts
      • Get OAuth authorization URL
      • List connected social accounts
      • Disconnect a social account
      • Get creator info for an account
      • List available Facebook Pages
      • Connect a Facebook Page
      • List connected Facebook Pages for a workspace
      • List available LinkedIn organizations
      • Connect a LinkedIn organization
      • List a Pinterest account's boards
      • Create a new Pinterest board for the connected account
      • Validate TikTok creator info
      • Preview the scheduled posts that would be cancelled if this account is
    • Workspaces
      • List workspaces for current user
      • Create a workspace
      • Get a workspace
      • Update a workspace
      • Delete a workspace
      • Update workspace AI settings
    • Team
      • List available permission scopes
      • List pending invitations for the current user
      • Get invitation details by token
      • Accept a workspace invitation
      • Decline a workspace invitation
      • List workspace members
      • Invite a user to the workspace
      • List pending invitations for a workspace
      • Cancel / revoke an invitation
      • Resend an invitation email
      • Update member role / scopes
      • Remove a member from the workspace
      • Leave a workspace
      • Upload a single chat attachment (≤5 MB) to S3 and return { name, url, fileType }
      • Channels the user can see: all workspace channels + DMs they're a member of
      • Create a channel or DM
      • /
      • /
      • /
      • /
      • Get groups
      • Create groups
      • Delete groupId
      • Update groupId
      • Get roles
      • Create roles
      • Delete roleId
      • Update roleId
    • Posts
      • List posts
      • Create a post
      • List upcoming scheduled posts
      • Delete multiple posts
      • Get a post
      • Update a post
      • Delete a post
      • Get analytics for a post
      • Reschedule a post
      • Retry a failed post
      • Cancel a scheduled post
      • Publish a draft post
      • Submit a post for approval
      • Record an approval decision
      • Get post version history
      • Rich, board-ready view of everything in the approval pipeline for the
      • All posts belonging to one Bulk Scheduler batch, in schedule order
      • Summaries of every batch created by the Bulk Scheduler in this workspace —
      • Create bulk
      • Aggregated dashboard metrics computed across ALL posts in the workspace
      • Ping the pending approvers of the post's current open stage
      • /
      • Body: { body, mentions?: [userId], attachments? }
      • /
      • /
      • Deliberately release a 'ready' post (an immediate post that has cleared
    • Assets
      • List assets
      • Bulk delete assets
      • Upload asset directly (multipart)
      • Get signed upload URL (step 1 of 2)
      • Confirm signed upload (step 2 of 2)
      • Get storage usage summary
      • List asset folders
      • Create a folder
      • Rename a folder
      • Delete a folder
      • List asset tags
      • Check thumbnail generation status
      • Get an asset
      • Update asset metadata
      • Delete an asset
      • Batch-resolve asset metadata (name, type, url, thumbnail) for a list of IDs
    • Uploads
      • Get a signed upload URL for post media
      • Get upload file info
      • Delete an uploaded file
      • List uploads
      • Confirm upload complete
      • Create validate url
    • Analytics
      • Get platform aggregate stats
      • Get platform stats as a time series
      • Get audience demographics for a platform
      • List content analytics for a platform
      • Get analytics for a specific content item
      • Delete a synced content record
      • Get time series for a specific content item
      • Get follower count trend over time
      • Get recommended posting times per platform
      • Get aggregated analytics for a post across platforms
      • Gather data → render HTML → print to PDF (Puppeteer) → stream as a download
      • Generate the AI analysis on demand so the builder can preview it before export
      • For the report builder: gathers (and caches) the data, then returns the list of
      • Renders the analytics report as a self-contained HTML page so the template
    • Streams
      • List streams
      • Create a stream
      • Get a stream
      • Delete a stream
      • Go live
      • Stop a live stream
      • Broadcast from a file
      • Update a stream
      • Check relay health and list active paths
      • Get relay status for a specific stream
      • Get streaming usage for the authenticated user (minutes, limits, active streams)
      • the relay (path + token) and re-arm fan-out, returning the WHIP URL so
    • Plans
      • List available subscription plans
    • Subscriptions
      • Get current subscription & credit balances
      • Renew or extend subscription
      • Wallet balances and recent ledger entries
      • Cancel subscription
      • Choose the term for the next renewal
      • Turn recurring billing on or off. Body: { enabled: boolean }
      • Get extra accounts
      • Create cancel removal
      • Create remove
    • Support
      • List support tickets
      • Create a support ticket
      • Get ticket statistics
      • Get a ticket
      • Reply to a ticket
      • Upload a ticket attachment
    • AI
      • Generate caption & hashtags for a media asset
      • Transcribe audio or video
      • Poll async AI job status
      • Get saved captions for an asset
      • Get AI credit usage summary for the workspace
      • Get AI credit usage as a chart series
      • Derive AI style settings from past posts
      • /
      • /
      • /
      • /
      • /
      • /
      • ?limit=30 (default 30, max 100)
      • /
    • Studio
      • List studio projects
      • Create a studio project
      • Get a studio project (includes full projectData)
      • Update a studio project
      • Delete a studio project
    • Payments
      • Pay for a purchase with wallet credit
      • Charge a saved payment method (for recurring subscriptions or credit purchases)
      • Get payment configuration for frontend (public key, supported currencies, etc.)
      • Create cryptocurrency payment invoice via Heleket
      • Initialize a payment (subscription or credit purchase)
      • Verify a payment
    • Bluesky OAuth
      • atproto client metadata
      • atproto client public keys (JWKS)
      • atproto OAuth callback
    • Apps
      • Public — list all active apps with their latest active version
      • Public — single app with all active versions
      • Public — download/redirect to latest version
      • Public — download specific version
    • Billing
      • Get user's billing cycles (all statuses for full history)
      • Calculate proration for upgrading cycles (no charge, just preview)
      • Manually create billing cycles from an existing transaction (admin/fix tool)
      • Select a plan after account creation (for free plans or initial plan selection)
      • Upgrade billing cycles to a new plan with proration
      • Preview the discount a coupon yields for a subscription checkout, so the
    • Blog
      • Published categories with post counts
      • Published posts, newest first. Query: page, limit (max 100), category
      • Single published post by slug
    • Books
      • List available books (metadata only — no file data)
      • Download a book's full JSON data from storage (S3 or local)
    • Platforms
      • Returns obfuscated platform capabilities for frontend
      • Returns capabilities for a specific platform
    • Ideas
      • Get ideas
      • Create ideas
      • Get boards
      • Create boards
      • Delete boardId
      • Update boardId
      • Delete ideaId
      • Get ideaId
      • Update ideaId
      • Get comments
      • Create comments
      • Delete commentId
      • Create convert
      • Update move
      • Create vote
    • Notifications
      • The current user's notification inbox (newest first) + unread count
      • Mark all of the user's notifications read
      • Lightweight unread badge count
      • Mark a single notification read
    • Queue
      • Clean old jobs from the queue
      • Clear jobs from the queue
      • Drain the queue (remove all jobs)
      • Get all jobs in the queue
      • Get queue statistics
    • Limits
      • Create archive
      • Create unarchive
      • Create remove
      • Create restore
      • Create suspend
      • Get status
      • Create archive
      • Create unarchive
    • Services
      • List all available service names
      • Get status of all services (public endpoint)
      • Get status of a specific service (public endpoint)
    • Approvals
      • Delete approval flow
      • Get approval flow
      • Replace approval flow
      • Create resolve stage
    • Schemas
      • ApiResponse
      • SuccessResponse
      • ErrorResponse
      • Pagination
      • User
      • SocialAccount
      • Workspace
      • PlatformPost
      • PlatformValidationFailure
      • Asset
      • PostContentOverride
      • PostApproval
      • Ticket
      • Plan
      • Post
      • Stream
      • StudioProject
      • AiJob
      • WalletEntry
      • Subscription

    MCP

    MCP Server#

    Connect any MCP-compatible AI assistant — Claude, Cursor, or Windsurf — directly to your Kabonshare account. Create posts, manage assets, run analytics, and more without leaving your AI client.
    npm
    License: MIT

    Quick Start#

    1
    Get your API key
    1.
    Log in to kabonshare.com
    2.
    Navigate to Settings → API
    3.
    Copy your API key
    2
    Connect your AI client
    Choose your client below and paste in your API key.
    Claude Desktop
    Cursor / Windsurf
    Edit claude_desktop_config.json:
    Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%\Claude\claude_desktop_config.json
    {
  "mcpServers": {
    "kabonshare": {
      "command": "npx",
      "args": ["kabonshare-mcp"],
      "env": {
        "KABONSHARE_API_URL": "https://api.kabonshare.com",
        "KABONSHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}
    Restart Claude Desktop after saving.
    3
    Start talking to your AI
    Once connected, just talk naturally. Your AI will use the right tools automatically.
    "Schedule a post for tomorrow 9am saying 'New feature just dropped' on Twitter and LinkedIn"

"What posts failed to publish this week?"

"Upload /Desktop/photo.jpg and post it to Instagram with an AI-generated caption"

"Show me my Twitter engagement stats for this month"

"What's the best time to post on Instagram this week?"

"Invite alex@team.com to the Marketing workspace as an editor"

"Go live on YouTube with title 'Q&A Session'"
    TIP
    Claude Desktop uses npx and requires Node.js 18+. Cursor and Windsurf connect directly to the hosted server — no installation needed.

    Requirements#

    Claude Desktop
    Node.js 18 or later. Uses npx kabonshare-mcp via stdio transport.
    Cursor / Windsurf
    No installation required. Connects to mcp.kabonshare.com via SSE.
    Kabonshare Account
    A Kabonshare account with at least one connected social account.
    API Key
    Generate your key from Settings → API inside your account.

    Available Tools#

    Posts
    Social Accounts
    Workspaces
    Profile & Settings
    Media & Assets
    AI
    Live Streams
    Analytics
    Studio (Video Editor)
    Capabilities
    Billing
    Team
    Support

    Resources#

    npm Package
    Install or run with npx kabonshare-mcp
    Source Code
    Open source on GitHub
    API Reference
    Full REST API documentation
    Support
    Get help from the Kabonshare team
    Modified at 2026-05-20 18:39:38
    Previous
    Overview
    Next
    Bluesky
    Built with