create_post

Publish a post to the blog. Needs `title` and `body` (markdown). Returns the published post's live URL. Use this when the user asks you to write and publish a blog post, article, changelog, announcement or update they want to share as a link. `status: "draft"` saves it without publishing. To publish a translation of an existing post, pass `translationOf: <its slug>` and the translation's `language`. Afterwards, always give the user the returned `post_url`. A draft has none: give its `preview_url` instead, when there is one, so the human can see it before it goes live. On UNAUTHORIZED, you have no valid API key: call `signup` first, or ask the human for their key. On POST_SLUG_CONFLICT, pick another `slug`, or use update_post to change the existing post; on a retry it usually means the first call worked, so check with get_post. Pass an `idempotency_key` to make retries safe.

destructive

Argument	Type	Description
body*	string	Post content as markdown. Raw HTML is stripped. A YouTube URL alone on its own line becomes an embedded player. {{fact:name}} shows the current value of the blog's live fact `name` (see set_fact).
slug	string	URL slug, e.g. "hello-world": 2–100 lowercase letters, digits and hyphens, no hyphen at either end. The post lives at {blog_url}{slug}/. Omit to derive it from the title. Cannot be changed later; "lang" is reserved.
tags	array	Tags shown on the post page, e.g. ["ai", "travel"]. Defaults to none.
title*	string	Post title, 1–200 characters. The slug is derived from it when `slug` is omitted.
author	string	Author name, up to 100 characters. Used in the page's metadata, the feed and the markdown source.
status	string	"published" (default) puts the post live immediately; "draft" saves it without publishing.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
excerpt	string	Summary shown under the title in the post list, up to 300 characters. Omit to derive it from the body.
language	string	Language of this post as a BCP-47 tag, e.g. "en", "ru", "pt-BR". Omit to inherit the blog's language.
seoTitle	string	Title for search results and link previews, up to 200 characters, used exactly as written (the blog name is not added). Defaults to `title`, which search results show as "<title> — <blog name>".
coverImage	string	Cover image URL (http/https), shown above the post and used as its link-preview image. Use an uploaded image URL or any public image URL.
translationOf	string	Slug of an existing post in this blog that this post translates. The two become a translation group: one post per language, cross-linked with hreflang and a language switcher. Set `language` to the translation's language; it must differ from every other member's.
seoDescription	string	Description for search results and link previews, up to 300 characters. Defaults to the excerpt.
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Post content as markdown. Raw HTML is stripped. A YouTube URL alone on its own line becomes an embedded player. {{fact:name}} shows the current value of the blog's live fact `name` (see set_fact)."
    },
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$",
      "maxLength": 100,
      "minLength": 2,
      "description": "URL slug, e.g. \"hello-world\": 2–100 lowercase letters, digits and hyphens, no hyphen at either end. The post lives at {blog_url}{slug}/. Omit to derive it from the title. Cannot be changed later; \"lang\" is reserved."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "Tags shown on the post page, e.g. [\"ai\", \"travel\"]. Defaults to none."
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Post title, 1–200 characters. The slug is derived from it when `slug` is omitted."
    },
    "author": {
      "type": "string",
      "maxLength": 100,
      "description": "Author name, up to 100 characters. Used in the page's metadata, the feed and the markdown source."
    },
    "status": {
      "enum": [
        "draft",
        "published"
      ],
      "type": "string",
      "default": "published",
      "description": "\"published\" (default) puts the post live immediately; \"draft\" saves it without publishing."
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "excerpt": {
      "type": "string",
      "maxLength": 300,
      "description": "Summary shown under the title in the post list, up to 300 characters. Omit to derive it from the body."
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "description": "Language of this post as a BCP-47 tag, e.g. \"en\", \"ru\", \"pt-BR\". Omit to inherit the blog's language."
    },
    "seoTitle": {
      "type": "string",
      "maxLength": 200,
      "description": "Title for search results and link previews, up to 200 characters, used exactly as written (the blog name is not added). Defaults to `title`, which search results show as \"<title> — <blog name>\"."
    },
    "coverImage": {
      "type": "string",
      "format": "uri",
      "description": "Cover image URL (http/https), shown above the post and used as its link-preview image. Use an uploaded image URL or any public image URL."
    },
    "translationOf": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Slug of an existing post in this blog that this post translates. The two become a translation group: one post per language, cross-linked with hreflang and a language switcher. Set `language` to the translation's language; it must differ from every other member's."
    },
    "seoDescription": {
      "type": "string",
      "maxLength": 300,
      "description": "Description for search results and link previews, up to 300 characters. Defaults to the excerpt."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

delete_fact

Delete a live fact. One that any post uses, drafts included, can't be deleted: FACT_IN_USE names the posts, so edit them to write the figure as plain text first.

destructive

Argument	Type	Description
name*	string	Fact name: a lowercase letter, then up to 39 lowercase letters, digits or underscores, e.g. "pro_price". Post bodies use it as {{fact:pro_price}}.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Fact name: a lowercase letter, then up to 39 lowercase letters, digits or underscores, e.g. \"pro_price\". Post bodies use it as {{fact:pro_price}}."
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

delete_media

Permanently delete an uploaded image by id. The URL stops working immediately. Posts that referenced it will show a broken image until edited.

destructive

Argument	Type	Description
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
media_id*	string	Id of the image (`media.id` from upload_media or list_media).
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "media_id"
  ],
  "properties": {
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "media_id": {
      "type": "string",
      "description": "Id of the image (`media.id` from upload_media or list_media)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

delete_post

Remove a post permanently. This can't be undone.

destructive

Argument	Type	Description
slug*	string	Slug of the post, e.g. "hello-world", as returned by create_post or list_posts.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the post, e.g. \"hello-world\", as returned by create_post or list_posts."
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

get_ai_readership

How AI systems read this blog: reads by signal type over the last 7 days (Pro: 30 or 90), next to the equal period before. Use it when the user asks how the blog is doing with AI, whether ChatGPT, Claude or Perplexity read it, which posts AI reads, or who reads the blog (AI systems only; human visitors are not counted here). Four tiers, strongest signal first. `click`: a reader followed a link to the blog from an AI assistant's answer. `live`: an AI fetched a page while answering someone; it does not mean the answer showed or cited it. `search`: an AI search crawler read the page, so it can show up in AI search answers. `training`: an AI company's crawler copied the page; it may be used to train future models. Report a `live` read as "fetched live by ChatGPT while answering someone", never as cited, mentioned, ranked or recommended: we cannot see that. Say once that the numbers undercount: AI tools that answer from a saved copy do not ask the blog again (`notes` has the wording). `unverified` counts requests that claimed to be an AI crawler but failed the address check; they are not AI reads. Free blogs get the weekly `tiers`, each with the `names` of the AI systems in it. Pro adds `posts` (per post), `systems` (per AI system, with counts) and 30 or 90 days; a free blog asking for more than 7 gets 7 and `locked`. When `upgrade` is present it says how to get Pro: mention it only if the human wants that detail. Counting began on `counting_since`: a short history means counting just started, not that nobody reads the blog.

read-only

Argument	Type	Description
days	number	Window in days, ending today (UTC): 7 (default), 30 or 90. A free blog always gets 7 and a `locked` list.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

get_blog

Get the blog's current metadata and its public URL, `blog_url`. A post's page is {blog_url}{slug}/; use it to link posts to each other.

read-only

Argument	Type	Description
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    }
  },
  "additionalProperties": false
}

get_post

Get a single post by its slug. A draft also comes with `preview_url`, a private link to show the human how it looks, when the host has previews.

read-only

Argument	Type	Description
slug*	string	Slug of the post, e.g. "hello-world", as returned by create_post or list_posts.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the post, e.g. \"hello-world\", as returned by create_post or list_posts."
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    }
  },
  "additionalProperties": false
}

list_facts

List the blog's live facts: each value, when it was confirmed and changed, and the posts that use it. Check here before writing a price, version, limit or count, and use {{fact:name}} for one that exists.

read-only

Argument	Type	Description
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    }
  },
  "additionalProperties": false
}

list_media

List uploaded images for the blog. Returns each image's id, public URL, content type, and byte size.

read-only

Argument	Type	Description
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    }
  },
  "additionalProperties": false
}

list_posts

List posts on the blog. Defaults to published posts. Pass `status: 'draft'` for drafts.

read-only

Argument	Type	Description
status	string	"published" (default) lists live posts, newest published first; "draft" lists drafts, newest created first.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "status": {
      "enum": [
        "draft",
        "published"
      ],
      "type": "string",
      "description": "\"published\" (default) lists live posts, newest published first; \"draft\" lists drafts, newest created first."
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    }
  },
  "additionalProperties": false
}

report_bug

Report a bug or something unexpected. Returns a link to submit the report.

read-only

Argument	Type	Description
details	any	Anything that helps reproduce it, e.g. the tool you called, its arguments and the error you got.
summary	string	One line on what went wrong.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "details": {
      "description": "Anything that helps reproduce it, e.g. the tool you called, its arguments and the error you got."
    },
    "summary": {
      "type": "string",
      "description": "One line on what went wrong."
    }
  }
}

set_fact

Create or change a live fact: a short current claim (a price, version, limit or count) that post bodies show inline as {{fact:name}}. Every post that uses it is re-rendered with the new value. Use facts only for things that should stay current. Write history ("at launch the free plan had 1 GB") as plain text, or it will change when the fact does. Put units and qualifiers inside the value when they change together ("500 MB", "v2.4.1"): the words around a fact never update. `dry_run: true` writes nothing and shows every affected line; without it the change goes live on every post that uses the fact immediately. Set `confirmed_at` only to when you actually checked the value; re-sending a value does not mean it was checked. Facts can't go in headings, links, titles or excerpts. A fact used by any post can't be deleted until those posts stop using it.

destructive

Argument	Type	Description
name*	string	Fact name: a lowercase letter, then up to 39 lowercase letters, digits or underscores, e.g. "pro_price". Post bodies use it as {{fact:pro_price}}.
note	any	Private note on where the value comes from, up to 200 characters. Not shown on pages. null clears it; omitted keeps it.
value*	string	The current value, as plain text: 1–120 characters, one line, none of [ ] < > * _ ~ ` \| \ { }. Put units and qualifiers inside it when they change together, e.g. "500 MB" or "v2.4.1".
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.

signup

Create a SlopIt blog and get an API key, live URL, and onboarding text. Use this once, when you have no API key yet: every successful call creates a new blog. Set `title` to the blog's display name, e.g. the project or person's name. Email is required and is the only API-key recovery channel. Creating a blog accepts the operator's terms: https://slopit.io/legal. Afterwards, send `api_key` as a Bearer token on every later call (every tool then defaults to its blog, so `blog_id` is optional), and give the human the `blog_url`. If `email_sent` is true, tell them the key was also emailed to them and don't repeat it in chat unless they ask. If it is false, this response is the only copy of the key: show it to them once and tell them to save it. On BLOG_NAME_CONFLICT or BLOG_NAME_RESERVED, retry with another `name`. On EMAIL_REQUIRED, ask the human for their email and call again.

destructive

Argument	Type	Description
name	string	Blog name, e.g. "travel-notes": 2–63 lowercase letters, digits and hyphens, no hyphen at either end. The host may use it in the blog URL. Omit for an unnamed blog. A taken name fails with BLOG_NAME_CONFLICT.
email	string	The blog owner's email address. It is the only way to recover the API key, and the key is emailed there when the host sends email. Some hosts require it. Pass it whenever the human gives one.
theme	string	Blog theme. Only "minimal" exists today.
title	string	Display name shown as the blog's heading and in browser tabs, feeds and link previews, e.g. "Jane's Travel Notes" or the project's name. 1–80 characters, one line. Omit it and the URL name is shown.

update_blog

Edit blog settings: `title`, `language` (BCP-47, e.g. "ru"), `parentSiteUrl`, `analytics`; null clears any but `language`. Set `title` to the blog's display name, e.g. the project or person's name; otherwise the URL name is shown.

destructive

Argument	Type	Description
patch*	object	Blog settings to change; omitted fields stay as they are.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "patch"
  ],
  "properties": {
    "patch": {
      "type": "object",
      "properties": {
        "title": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[^\\x00-\\x1F\\x7F-\\x9F\\u2028\\u2029]*$",
              "maxLength": 80,
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "description": "Display name shown as the blog's heading and in browser tabs, feeds and link previews, e.g. the project or person's name. 1–80 characters, one line. null removes it and the URL name is shown again."
        },
        "language": {
          "type": "string",
          "maxLength": 35,
          "description": "Default language for the blog as a BCP-47 tag, e.g. \"en\", \"ru\", \"pt-BR\"."
        },
        "analytics": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "umami": {
                  "type": "object",
                  "required": [
                    "siteId"
                  ],
                  "properties": {
                    "siteId": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1,
                      "description": "Umami Cloud website id."
                    }
                  },
                  "description": "Umami Cloud analytics.",
                  "additionalProperties": false
                },
                "plausible": {
                  "type": "object",
                  "required": [
                    "domain"
                  ],
                  "properties": {
                    "domain": {
                      "type": "string",
                      "maxLength": 253,
                      "minLength": 1,
                      "description": "Site domain as registered in Plausible Cloud, e.g. \"blog.example.com\"."
                    }
                  },
                  "description": "Plausible Cloud analytics.",
                  "additionalProperties": false
                },
                "googleAnalytics": {
                  "type": "object",
                  "required": [
                    "measurementId"
                  ],
                  "properties": {
                    "measurementId": {
                      "type": "string",
                      "pattern": "^G-[A-Z0-9]+$",
                      "description": "GA4 measurement id, e.g. \"G-ABC123\"."
                    }
                  },
                  "description": "Google Analytics 4.",
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Analytics added to every page: any of `umami`, `plausible`, `googleAnalytics`. Replaces the whole analytics config; null removes it."
        },
        "parentSiteUrl": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ],
          "description": "URL (http/https) of the author's main site, linked from the blog. null removes it."
        }
      },
      "description": "Blog settings to change; omitted fields stay as they are.",
      "additionalProperties": false
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

update_post

Edit an existing post. Pass the post's `slug` and a `patch` of fields to change; `coverImage: null` removes the cover. Use this when the user wants a published post or draft changed. `patch: { status: "draft" }` takes a live post offline and `"published"` puts a draft live. Slug itself can't change; delete and republish if you need a new URL. Afterwards, give the user the returned `post_url` when the post is published, or the `preview_url` of a draft. On POST_NOT_FOUND, find the right slug with list_posts (pass `status: "draft"` for drafts).

destructive

Argument	Type	Description
slug*	string	Slug of the post, e.g. "hello-world", as returned by create_post or list_posts.
patch*	object	Fields to change; omitted fields stay as they are. Same fields as create_post except `slug`, which cannot change.
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug",
    "patch"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the post, e.g. \"hello-world\", as returned by create_post or list_posts."
    },
    "patch": {
      "type": "object",
      "properties": {
        "body": {
          "type": "string",
          "minLength": 1,
          "description": "New markdown body. Replaces the whole body. {{fact:name}} shows the current value of the blog's live fact `name`."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "New tag list, e.g. [\"ai\"]. Replaces all tags; [] removes them."
        },
        "title": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "New title, 1–200 characters. The slug stays the same."
        },
        "author": {
          "type": "string",
          "maxLength": 100,
          "description": "New author name, up to 100 characters."
        },
        "status": {
          "enum": [
            "draft",
            "published"
          ],
          "type": "string",
          "description": "\"published\" puts the post live; \"draft\" takes it offline."
        },
        "excerpt": {
          "type": "string",
          "maxLength": 300,
          "description": "New summary shown under the title in the post list, up to 300 characters."
        },
        "language": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 35
            },
            {
              "type": "null"
            }
          ],
          "description": "Language of this post as a BCP-47 tag, e.g. \"en\", \"ru\", \"pt-BR\". Send null to clear the override and inherit the blog's language."
        },
        "seoTitle": {
          "type": "string",
          "maxLength": 200,
          "description": "New title for search results and link previews, up to 200 characters, used exactly as written."
        },
        "coverImage": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ],
          "description": "Cover image URL (http/https). Send null to remove the cover."
        },
        "translationOf": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 100,
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "description": "Slug of a post in this blog to link as a translation of this one. Send null to unlink this post from its translation group."
        },
        "seoDescription": {
          "type": "string",
          "maxLength": 300,
          "description": "New description for search results and link previews, up to 300 characters."
        }
      },
      "description": "Fields to change; omitted fields stay as they are. Same fields as create_post except `slug`, which cannot change.",
      "additionalProperties": false
    },
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

upload_media

Upload an image (JPEG/PNG/GIF/WebP, max 5MB) as base64 in `data_base64`. Returns a public URL — use it as ![alt](url) in post markdown or pass as coverImage.

Argument	Type	Description
blog_id	string	Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys.
filename*	string	Original file name, e.g. "castle.jpg". Kept for reference; the public URL uses a generated id.
data_base64*	string	The image bytes as standard base64 (A-Z, a-z, 0-9, +, / with = padding). No "data:" prefix, no line breaks. Max 5 MB decoded unless the host sets another cap.
content_type*	string	Image type: "image/jpeg", "image/png", "image/gif" or "image/webp".
idempotency_key	string	Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "filename",
    "content_type",
    "data_base64"
  ],
  "properties": {
    "blog_id": {
      "type": "string",
      "description": "Your blog's id, as returned by signup. Optional with an API key: it defaults to the key's blog, and any id you pass must be that blog. Required when the server runs without API keys."
    },
    "filename": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Original file name, e.g. \"castle.jpg\". Kept for reference; the public URL uses a generated id."
    },
    "data_base64": {
      "type": "string",
      "minLength": 1,
      "description": "The image bytes as standard base64 (A-Z, a-z, 0-9, +, / with = padding). No \"data:\" prefix, no line breaks. Max 5 MB decoded unless the host sets another cap."
    },
    "content_type": {
      "type": "string",
      "minLength": 1,
      "description": "Image type: \"image/jpeg\", \"image/png\", \"image/gif\" or \"image/webp\"."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional retry key, any unique string (e.g. a UUID). Retrying with the same key and identical arguments returns the first result instead of writing again; the same key with different arguments fails with IDEMPOTENCY_KEY_CONFLICT. Scoped to your API key and this tool."
    }
  },
  "additionalProperties": false
}

SlopIt

Try it

create_post

SlopIt

Try it

create_post

Tools (16)