bsocial_publish

Publish a post, reply, reaction or message with your BAP identity.

Example

{
  "action": {
    "type": "post",
    "content": "Hello Bitcoin",
    "contentType": "text/plain"
  },
  "preview": true
}

Result

Transaction ID, action type and output count; preview returns unsigned output scripts without spending.

Permissions

The selected identity wallet signs and funds through its existing permissions. Legacy wallets require a separate identity key plus a payment key. Broadcasting must be enabled unless preview is true.

Choose action.type. Replies are posts with replyTo. Tags and attachments have separately signed outputs. A message recipient is routing metadata, not encryption. Friend records advertise a supplied communication public key and do not establish a secure messaging protocol. unfriend and video are indexer extensions.

Inputs and availability

full and compact catalog · Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault + sponsor

Full tool description

Publish a signed Bitcoin Schema social action: post/reply, repost, like/unlike, follow/unfollow, friend/unfriend, message, or video. Posts/messages support context, tags and attachments. Content is public and permanent; recipient context does NOT encrypt a message. Friend records require your communication public key from an established key-agreement workflow. Requires the selected BAP identity wallet or explicit legacy identity key and funding. Use preview to inspect unsigned outputs without spending.

Field	Type / required	Description
action	object Required	See schema for details.
preview	boolean Optional	Return unsigned output scripts without signing, funding, or broadcasting. default: false

action.type = "post"

Field	Type / required	Description
action.type	string Required	See schema for details. const: "post"
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.content	string Required	See schema for details. minLength: 1; maxLength: 400000
action.contentType	string Optional	See schema for details. default: "text/plain"; maxLength: 128; pattern: "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
action.encoding	"utf8" \| "base64" Optional	Input encoding. Base64 is decoded to binary B content. default: "utf8"
action.filename	string Optional	See schema for details. maxLength: 255
action.context	object Optional	See schema for details.
action.context.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.context.value	string Required	See schema for details. minLength: 1; maxLength: 2048
action.subcontext	object Optional	See schema for details.
action.subcontext.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.subcontext.value	string Required	See schema for details. minLength: 1; maxLength: 2048
action.tags	array of string Optional	See schema for details. maxItems: 50
action.attachments	array of object Optional	See schema for details. maxItems: 8
action.attachments[].content	string Required	See schema for details. minLength: 1; maxLength: 400000
action.attachments[].contentType	string Optional	See schema for details. default: "text/plain"; maxLength: 128; pattern: "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
action.attachments[].encoding	"utf8" \| "base64" Optional	Input encoding. Base64 is decoded to binary B content. default: "utf8"
action.attachments[].filename	string Optional	See schema for details. maxLength: 255
action.replyTo	string Optional	See schema for details. pattern: "^[a-f0-9]{64}$"

action.type = "repost"

Field	Type / required	Description
action.type	string Required	See schema for details. const: "repost"
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.txid	string Required	See schema for details. pattern: "^[a-f0-9]{64}$"
action.context	object Optional	See schema for details.
action.context.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.context.value	string Required	See schema for details. minLength: 1; maxLength: 2048
action.subcontext	object Optional	See schema for details.
action.subcontext.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.subcontext.value	string Required	See schema for details. minLength: 1; maxLength: 2048

action.type = "like" | "unlike"

Field	Type / required	Description
action.type	"like" \| "unlike" Required	See schema for details.
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.txid	string Required	See schema for details. pattern: "^[a-f0-9]{64}$"
action.emoji	string Optional	See schema for details. minLength: 1; maxLength: 32

action.type = "follow" | "unfollow" | "unfriend"

Field	Type / required	Description
action.type	"follow" \| "unfollow" \| "unfriend" Required	See schema for details.
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.bapId	string Required	See schema for details. minLength: 1; maxLength: 128; pattern: "^[a-zA-Z0-9]+$"

action.type = "friend"

Field	Type / required	Description
action.type	string Required	See schema for details. const: "friend"
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.bapId	string Required	See schema for details. minLength: 1; maxLength: 128; pattern: "^[a-zA-Z0-9]+$"
action.publicKey	string Required	Your communication public key, from the existing wallet/key-agreement workflow. This record does not establish encryption by itself. pattern: "^(02\|03)[a-f0-9]{64}$"

action.type = "message"

Field	Type / required	Description
action.type	string Required	See schema for details. const: "message"
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.content	string Required	See schema for details. minLength: 1; maxLength: 400000
action.contentType	string Optional	See schema for details. default: "text/plain"; maxLength: 128; pattern: "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
action.encoding	"utf8" \| "base64" Optional	Input encoding. Base64 is decoded to binary B content. default: "utf8"
action.filename	string Optional	See schema for details. maxLength: 255
action.context	object Optional	See schema for details.
action.context.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.context.value	string Required	See schema for details. minLength: 1; maxLength: 2048
action.subcontext	object Optional	See schema for details.
action.subcontext.key	string Required	See schema for details. minLength: 1; maxLength: 64; pattern: "^[a-zA-Z][a-zA-Z0-9_.-]*$"
action.subcontext.value	string Required	See schema for details. minLength: 1; maxLength: 2048
action.tags	array of string Optional	See schema for details. maxItems: 50
action.attachments	array of object Optional	See schema for details. maxItems: 8
action.attachments[].content	string Required	See schema for details. minLength: 1; maxLength: 400000
action.attachments[].contentType	string Optional	See schema for details. default: "text/plain"; maxLength: 128; pattern: "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
action.attachments[].encoding	"utf8" \| "base64" Optional	Input encoding. Base64 is decoded to binary B content. default: "utf8"
action.attachments[].filename	string Optional	See schema for details. maxLength: 255

action.type = "video"

Field	Type / required	Description
action.type	string Required	See schema for details. const: "video"
action.app	string Optional	See schema for details. default: "bsv-mcp"; minLength: 1; maxLength: 100
action.provider	string Required	See schema for details. minLength: 1; maxLength: 100
action.videoID	string Required	See schema for details. minLength: 1; maxLength: 512
action.channel	string Optional	See schema for details. minLength: 1; maxLength: 256
action.duration	number Optional	See schema for details. minimum: 0
action.start	number Optional	See schema for details. minimum: 0

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "action": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "post"
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "content": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400000
            },
            "contentType": {
              "default": "text/plain",
              "type": "string",
              "maxLength": 128,
              "pattern": "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
            },
            "encoding": {
              "default": "utf8",
              "description": "Input encoding. Base64 is decoded to binary B content.",
              "type": "string",
              "enum": [
                "utf8",
                "base64"
              ]
            },
            "filename": {
              "type": "string",
              "maxLength": 255
            },
            "context": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            },
            "subcontext": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            },
            "tags": {
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "attachments": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 400000
                  },
                  "contentType": {
                    "default": "text/plain",
                    "type": "string",
                    "maxLength": 128,
                    "pattern": "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
                  },
                  "encoding": {
                    "default": "utf8",
                    "description": "Input encoding. Base64 is decoded to binary B content.",
                    "type": "string",
                    "enum": [
                      "utf8",
                      "base64"
                    ]
                  },
                  "filename": {
                    "type": "string",
                    "maxLength": 255
                  }
                },
                "required": [
                  "content"
                ],
                "additionalProperties": false
              }
            },
            "replyTo": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "required": [
            "type",
            "content"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "repost"
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "txid": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "context": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            },
            "subcontext": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "type",
            "txid"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "like",
                "unlike"
              ]
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "txid": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "emoji": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32
            }
          },
          "required": [
            "type",
            "txid"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "follow",
                "unfollow",
                "unfriend"
              ]
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "bapId": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[a-zA-Z0-9]+$"
            }
          },
          "required": [
            "type",
            "bapId"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "friend"
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "bapId": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "pattern": "^[a-zA-Z0-9]+$"
            },
            "publicKey": {
              "type": "string",
              "pattern": "^(02|03)[a-f0-9]{64}$",
              "description": "Your communication public key, from the existing wallet/key-agreement workflow. This record does not establish encryption by itself."
            }
          },
          "required": [
            "type",
            "bapId",
            "publicKey"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "message"
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "content": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400000
            },
            "contentType": {
              "default": "text/plain",
              "type": "string",
              "maxLength": 128,
              "pattern": "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
            },
            "encoding": {
              "default": "utf8",
              "description": "Input encoding. Base64 is decoded to binary B content.",
              "type": "string",
              "enum": [
                "utf8",
                "base64"
              ]
            },
            "filename": {
              "type": "string",
              "maxLength": 255
            },
            "context": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            },
            "subcontext": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
                },
                "value": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2048
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            },
            "tags": {
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "attachments": {
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 400000
                  },
                  "contentType": {
                    "default": "text/plain",
                    "type": "string",
                    "maxLength": 128,
                    "pattern": "^[\\w.+-]+\\/[\\w.+-]+(?:;[^\\r\\n]*)?$"
                  },
                  "encoding": {
                    "default": "utf8",
                    "description": "Input encoding. Base64 is decoded to binary B content.",
                    "type": "string",
                    "enum": [
                      "utf8",
                      "base64"
                    ]
                  },
                  "filename": {
                    "type": "string",
                    "maxLength": 255
                  }
                },
                "required": [
                  "content"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "type",
            "content"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "video"
            },
            "app": {
              "default": "bsv-mcp",
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "provider": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "videoID": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            },
            "channel": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256
            },
            "duration": {
              "type": "number",
              "minimum": 0
            },
            "start": {
              "type": "number",
              "minimum": 0
            }
          },
          "required": [
            "type",
            "provider",
            "videoID"
          ],
          "additionalProperties": false
        }
      ]
    },
    "preview": {
      "default": false,
      "description": "Return unsigned output scripts without signing, funding, or broadcasting.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}