create_post
ActiveTool of FavCRM
declared in 1.0.0
Create a new CMS post (blog_post, page, or any custom post type). The post type must already exist — use list_post_types to discover, create_post_type to add a new one. excerpt = plain-text summary only (auto-derived from blocks if omitted). Structured custom fields go in meta, keyed by the field schema defined with create_post_type_field.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"type",
"title"
],
"properties": {
"meta": {
"type": "object",
"description": "Structured custom field values, keyed by field key (see list_post_type_fields). Validated against the post type field schema. Use this for all machine-readable data — never put JSON in excerpt.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"slug": {
"type": "string",
"description": "URL slug. Auto-generated from title if omitted; collisions get -2, -3 suffix."
},
"type": {
"type": "string",
"description": "Post type slug (e.g. blog_post, page, treatment). Must exist in post_types for this company."
},
"title": {
"type": "string",
"description": "Post title"
},
"blocks": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
},
"description": "Ordered array of content blocks. Each block has { id, version, type, data } where type is one of: paragraph, heading, image, list, quote, code, divider, spacer, embed, html, youtube, file, faq, callout, gallery, cta, accordion, product, columns. Unknown types are rejected."
},
"status": {
"enum": [
"draft",
"scheduled",
"published",
"archived"
],
"type": "string",
"description": "Status (default draft)"
},
"tagIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tag IDs to attach to the post"
},
"excerpt": {
"type": "string",
"description": "Plain-text summary only — never JSON. Auto-derived from the first paragraph/heading block if omitted and the post type supports excerpts."
},
"parentId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Parent post ID for nested types (e.g. pages)."
},
"seoTitle": {
"type": "string",
"description": "SEO title override"
},
"sortOrder": {
"type": "number",
"description": "Sort order (lower = earlier)"
},
"visibility": {
"enum": [
"public",
"private",
"members_only"
],
"type": "string",
"description": "Visibility (default public)"
},
"categoryIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Category IDs (post types with supportsCategories only)"
},
"publishedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO timestamp; required when status=scheduled."
},
"featuredImage": {
"type": "string",
"description": "Cover image URL"
},
"seoDescription": {
"type": "string",
"description": "SEO meta description"
}
},
"definitions": {
"__schema0": {
"oneOf": [
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "paragraph"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"level",
"text"
],
"properties": {
"text": {
"type": "string",
"minLength": 1
},
"level": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
]
},
"anchor": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "heading"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"url",
"alt"
],
"properties": {
"alt": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
},
"caption": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "image"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"ordered",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1
},
"ordered": {
"type": "boolean"
}
}
},
"type": {
"type": "string",
"const": "list"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"text"
],
"properties": {
"cite": {
"type": "string"
},
"text": {
"type": "string",
"minLength": 1
}
}
},
"type": {
"type": "string",
"const": "quote"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"lang",
"code"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"lang": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "code"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"type": {
"type": "string",
"const": "divider"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"size"
],
"properties": {
"size": {
"enum": [
"sm",
"md",
"lg"
],
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "spacer"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"provider",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"provider": {
"enum": [
"youtube",
"vimeo",
"iframe"
],
"type": "string"
},
"aspectRatio": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "embed"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"minLength": 1
}
}
},
"type": {
"type": "string",
"const": "html"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"videoId"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"title": {
"type": "string"
},
"videoId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$"
},
"aspectRatio": {
"type": "string"
},
"startSeconds": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
"type": {
"type": "string",
"const": "youtube"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"url",
"mimeType",
"sizeBytes",
"originalName"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"icon": {
"enum": [
"pdf",
"doc",
"image",
"video",
"audio",
"generic"
],
"type": "string"
},
"mimeType": {
"type": "string",
"minLength": 1
},
"sizeBytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"displayName": {
"type": "string"
},
"originalName": {
"type": "string",
"minLength": 1
}
}
},
"type": {
"type": "string",
"const": "file"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"question",
"answer"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"answer": {
"type": "string"
},
"question": {
"type": "string",
"minLength": 1
}
}
}
},
"title": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "faq"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"tone",
"body"
],
"properties": {
"body": {
"type": "string",
"minLength": 1
},
"tone": {
"enum": [
"info",
"success",
"warning",
"danger",
"note"
],
"type": "string"
},
"title": {
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "callout"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"layout",
"images"
],
"properties": {
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"alt"
],
"properties": {
"alt": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"caption": {
"type": "string"
}
}
}
},
"layout": {
"enum": [
"grid",
"masonry",
"carousel"
],
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "gallery"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"label",
"href"
],
"properties": {
"href": {
"type": "string",
"minLength": 1
},
"label": {
"type": "string",
"minLength": 1
},
"style": {
"enum": [
"primary",
"secondary",
"ghost"
],
"type": "string"
},
"openInNewTab": {
"type": "boolean"
}
}
},
"type": {
"type": "string",
"const": "cta"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"body"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"body": {
"type": "string"
},
"title": {
"type": "string",
"minLength": 1
}
}
}
},
"semantic": {
"enum": [
"faq",
"plain"
],
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "accordion"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"minLength": 1
},
"layout": {
"enum": [
"card",
"inline"
],
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "product"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
},
{
"type": "object",
"required": [
"id",
"version",
"type",
"data"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"data": {
"type": "object",
"required": [
"columns"
],
"properties": {
"align": {
"enum": [
"start",
"center",
"stretch"
],
"type": "string"
},
"columns": {
"type": "array",
"items": {
"type": "object",
"required": [
"blocks"
],
"properties": {
"span": {
"type": "number",
"exclusiveMinimum": 0
},
"blocks": {
"type": "array",
"items": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
}
}
}
},
"maxItems": 4,
"minItems": 2
},
"stackBelow": {
"type": "string",
"pattern": "^(0|[0-9]+(\\.[0-9]+)?(px|rem|em|vw|vh|%))$"
}
}
},
"type": {
"type": "string",
"const": "columns"
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}
]
}
}
}Parent server
FavCRM
https://github.com/favcrm/mcp
1/7 registries