← BSV MCPInstall
Social

bsocial_createPost

Create a social post on the BSV blockchain using B:// and MAP protocols. Posts are stored permanently on-chain and can include plain text or markdown content.

Read as Markdown

Result

An MCP result containing the operation outcome as text, with structured content where supplied. Check isError before using it; an output schema is shown when registered.

Permissions

This operation can change wallet, account or service state. A connected wallet applies its own permissions. Guarded broadcasts also require broadcasting to be enabled; service authorization is separate from wallet approval.

Definition 1

Full catalog · Legacy local wallet; Legacy local identity

FieldType / requiredDescription
contentstring
Required
The content of the post
contentType"text/plain" | "text/markdown"
Optional
Content type of the post

default: "text/plain"

appstring
Optional
Application name creating the post

default: "bsv-mcp"

additionalMapDatastring
Optional
Additional MAP protocol key-value pairs as a JSON object string, e.g. '{"key": "value"}'

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

Full input schema
{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The content of the post"
    },
    "contentType": {
      "default": "text/plain",
      "description": "Content type of the post",
      "type": "string",
      "enum": [
        "text/plain",
        "text/markdown"
      ]
    },
    "app": {
      "default": "bsv-mcp",
      "description": "Application name creating the post",
      "type": "string"
    },
    "additionalMapData": {
      "description": "Additional MAP protocol key-value pairs as a JSON object string, e.g. '{\"key\": \"value\"}'",
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Definition 2

Full catalog · Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault + sponsor

Publish a BSocial post with an AIP signature from the selected BAP identity wallet. Requires a published identity. The identity wallet funds the transaction; content becomes public on chain.

FieldType / requiredDescription
contentstring
Required
See schema for details.

minLength: 1; maxLength: 100000

contentType"text/plain" | "text/markdown"
Optional
See schema for details.

default: "text/plain"

appstring
Optional
See schema for details.

default: "bsv-mcp"; minLength: 1; maxLength: 100

tagsarray of string
Optional
See schema for details.

maxItems: 50

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

Full input schema
{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100000
    },
    "contentType": {
      "default": "text/plain",
      "type": "string",
      "enum": [
        "text/plain",
        "text/markdown"
      ]
    },
    "app": {
      "default": "bsv-mcp",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      }
    }
  },
  "required": [
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}