`connections_status`

Get publish connection status

Use this before preparing or publishing packages for a platform. Returns whether this BitterClip account has a connected destination with the required permissions for the requested platform (YouTube: a channel with upload permission, plus whether the requested privacy will be honored or forced private; LinkedIn: a member account with w_member_social; X: an account with tweet.write and media.write), and the in-app path to start connection if not.

Surface: App-only

Product release 1dce717408a55fac1047e7d779177fa3ef8ede51
Public contract commit 1ce47f7857ae3d9b6933fe83d5c33de3ae5efc64
Public contract SHA-256 241d47d25e4b4c1dae9d2263793874d06fc4ba7bc3c78d4cf2bc63fbb32ed7dc
Captured 2026-09-24T16:39:30.100Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

App descriptor

{
  "name": "connections_status",
  "title": "Get publish connection status",
  "description": "Use this before preparing or publishing packages for a platform. Returns whether this BitterClip account has a connected destination with the required permissions for the requested platform (YouTube: a channel with upload permission, plus whether the requested privacy will be honored or forced private; LinkedIn: a member account with w_member_social; X: an account with tweet.write and media.write), and the in-app path to start connection if not.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "platform": {
        "type": "string",
        "enum": [
          "youtube",
          "linkedin",
          "x"
        ],
        "description": "Publish destination to check."
      }
    },
    "required": [
      "platform"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "app"
      ]
    },
    "openai/widgetAccessible": true,
    "openai/visibility": "private"
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "platform": {
        "type": "string",
        "enum": [
          "youtube",
          "linkedin",
          "x"
        ]
      },
      "connected": {
        "type": "boolean"
      },
      "connection": {
        "type": [
          "object",
          "null"
        ]
      },
      "connections": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "default_connection_public_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "target_channel_id": {
        "type": [
          "string",
          "null"
        ],
        "description": "YouTube only."
      },
      "target_channel_url": {
        "type": [
          "string",
          "null"
        ],
        "description": "YouTube only."
      },
      "target_channel_required": {
        "type": "boolean",
        "description": "YouTube only."
      },
      "required_scope": {
        "type": "string"
      },
      "required_scopes": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "default_privacy_status": {
        "type": "string",
        "enum": [
          "private",
          "unlisted",
          "public"
        ],
        "description": "YouTube only."
      },
      "privacy_policy": {
        "type": "object",
        "description": "YouTube only."
      },
      "settings_path": {
        "type": "string"
      },
      "authorize_path": {
        "type": "string"
      },
      "connection_management": {
        "type": "object"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "invalid_input"
]

Examples

[]