Developers

Let your agents Beastify.

One REST API, an MCP server and an agent skill. Same engine as the website: post analysis, rewrites, meme search, and image + video meme rendering. Included with Pro.

Quick start

  1. 1
    Get a key

    Create one in Dashboard → API & MCP (Pro).

  2. 2
    Make a call

    POST /api/v1/improve with a post. Get rewrites and a meme back.

  3. 3
    Or plug in your agent

    Add the MCP server or drop in the skill.

Authentication

Every request needs your key as a bearer token. Keys start with bst_, are shown once, and can be revoked anytime. Keep them server-side. The base URL is https://beastify.xyz/api/v1; requests and responses are JSON.

Header
Authorization: Bearer bst_…
POST/api/v1/improve

Improve a post

Analyzes a post (main weakness + editorial scores) and returns 3–4 rewrites with different strategies. Optionally picks a fitting meme template, writes the captions and renders it.

ParameterTypeDescription
postrequiredstringThe post or rough draft (up to 2,000 characters).
media{ kind: "image" | "video", dataUrl }Optional image or video attached to the post. dataUrl is a JPEG, PNG or WebP data URL under ~650 KB. For a video, send one image tiling 4 frames spread across it (2×2 grid, e.g. at 1/5, 2/5, 3/5 and 4/5 of its length). The analysis then includes mediaSummary; pass it to /transform as mediaSummary to keep that context.
memetrue | false | "auto""auto" (default) adds a meme only when one fits, true always tries, false never.

Request

curl https://beastify.xyz/api/v1/improve \
  -H "Authorization: Bearer $BEASTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post": "We just launched a new feature that lets teams have fewer meetings because everything is in one place.",
    "meme": "auto"
  }'

Response

200 OK · JSON
{
  "id": "6720c1f4e3a1b2c3d4e5f601",
  "analysis": {
    "mainWeakness": "You're explaining the feature before giving people a reason to care.",
    "scores": { "hook": 3, "clarity": 7, "specificity": 5, "curiosity": 4, "personality": 6, "conversation": 7 }
  },
  "variants": [
    {
      "id": "a1",
      "strategy": "Best",
      "text": "Your team doesn't need another tool. It needs fewer meetings.\n\nWe just shipped one place for everything."
    },
    { "id": "a2", "strategy": "Punchy", "text": "Fewer tools. Fewer meetings. One place." }
  ],
  "meme": {
    "handle": "drake-hotline-bling",
    "name": "Drake Hotline Bling",
    "mediaType": "image",
    "mimeType": "image/jpeg",
    "url": "https://static.beastify.xyz/memes/2026-10-02/drake-hotline-bling-….jpg",
    "width": 1200,
    "height": 1200,
    "inputs": { "text1": "Explaining the feature first", "text2": "Leading with the pain" },
    "reason": "Contrasts the weak opener with the stronger one."
  }
}

Result

The meme that came back with this post (drake-hotline-bling).
The meme that came back with this post (drake-hotline-bling).
POST/api/v1/transform

Remix a version

Applies one quick transformation to a version of the post.

ParameterTypeDescription
textrequiredstringThe version to transform.
kindrequiredstringshorter, hook (stronger hook), human (more human), funnier or angle (new angle).
originalstringThe original post, for context.

Request

curl https://beastify.xyz/api/v1/transform \
  -H "Authorization: Bearer $BEASTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your team doesn't need another tool. It needs fewer meetings.",
    "kind": "funnier"
  }'

Response

200 OK · JSON
{
  "variant": {
    "id": "b7",
    "strategy": "Funny",
    "text": "Your team doesn't need another tool. It needs a meeting about having fewer meetings. (Kidding. We built the tool.)"
  }
}
GET/api/v1/memes/two-buttons

Get a template

A template's caption fields with what each one is for and an example, so you (or your model) can write captions that fit.

Request

curl "https://beastify.xyz/api/v1/memes/two-buttons" \
  -H "Authorization: Bearer $BEASTIFY_API_KEY"

Response

200 OK · JSON
{
  "handle": "two-buttons",
  "name": "Two Buttons",
  "mediaType": "image",
  "width": 600,
  "height": 908,
  "inputs": [
    {
      "key": "text1",
      "label": "Left button choice",
      "alias": "left_option",
      "description": "Write one of the options the person is tempted to choose.",
      "example": "Go to bed before midnight"
    },
    {
      "key": "text2",
      "label": "Right button choice",
      "alias": "right_option",
      "description": "Write the competing option that makes the decision difficult.",
      "example": "Watch one more cooking video"
    },
    {
      "key": "text3",
      "label": "The person deciding",
      "alias": "chooser",
      "description": "Describe who is struggling or what situation has them sweating.",
      "example": "Me with an early meeting tomorrow"
    }
  ],
  "thumbUrl": "https://beastify.xyz/memes/thumb/two-buttons.jpg"
}
POST/api/v1/memes/two-buttons/generate

Generate a meme

Renders a template with your captions. Image templates return a JPEG; video/GIF templates return an MP4, or an animated GIF with "format": "gif". Keys can be text1… or their alias (e.g. left_option); blank captions are skipped. Templates with picture slots (inputs of type image, keys image1…) take an https:// image URL or a data:image/…;base64 URL.

ParameterTypeDescription
inputsrequiredobjectCaptions keyed by input key or alias, e.g. { "text1": "…" }. Picture slots (image1…) take an image URL.
format"mp4" | "gif"Video/GIF templates only. Default mp4.

Request

curl https://beastify.xyz/api/v1/memes/two-buttons/generate \
  -H "Authorization: Bearer $BEASTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "text1": "Ship it Friday",
      "text2": "Write the tests",
      "text3": "Me at 4:59pm"
    }
  }'

Response

200 OK · JSON
{
  "meme": {
    "handle": "two-buttons",
    "name": "Two Buttons",
    "mediaType": "image",
    "mimeType": "image/jpeg",
    "url": "https://static.beastify.xyz/memes/2026-10-02/two-buttons-….jpg",
    "width": 600,
    "height": 908,
    "inputs": { "text1": "Ship it Friday", "text2": "Write the tests", "text3": "Me at 4:59pm" }
  }
}

Result

two-buttons → JPEG
two-buttons → JPEG
chef-skinner-reading-a-letter → MP4 ({"text1": "Reading my own code from last week"})
POST/api/v1/memes/suggest

Suggest a meme for a post

Lets Beastify pick the best-fitting template for a post, write the captions and render it. Returns "meme": null when nothing fits well. Pass exclude to try another.

ParameterTypeDescription
postrequiredstringThe post the meme should go with.
querystringOptional hint for the template search.
excludestring[]Handles to skip.

Request

curl https://beastify.xyz/api/v1/memes/suggest \
  -H "Authorization: Bearer $BEASTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post": "We cut 14 SaaS subscriptions last quarter. Nobody noticed."
  }'

Response

200 OK · JSON
{
  "meme": {
    "handle": "distracted-boyfriend",
    "name": "Distracted Boyfriend",
    "mediaType": "image",
    "mimeType": "image/jpeg",
    "url": "https://static.beastify.xyz/memes/2026-10-02/distracted-boyfriend-….jpg",
    "inputs": { "text1": "One focused tool", "text2": "My team", "text3": "Our 14 SaaS subscriptions" },
    "reason": "Shows the team leaving the bloated stack for one simple tool."
  }
}

Result

distracted-boyfriend, picked and captioned by Beastify.
distracted-boyfriend, picked and captioned by Beastify.
GET/api/v1/me

Your account

Check which account and plan a key belongs to.

Request

curl "https://beastify.xyz/api/v1/me" \
  -H "Authorization: Bearer $BEASTIFY_API_KEY"

Response

200 OK · JSON
{
  "email": "[email protected]",
  "plan": "pro"
}

Media URLs returned by the API are valid for 12 hours (memes with an uploaded picture: 10 days). The first request renders the meme, so it can take a few seconds for videos. Download or re-host anything you want to keep. Video renders take a few seconds, so use a client timeout of at least 120 seconds.

MCP server

A Streamable HTTP MCP server at https://beastify.xyz/mcp, authenticated with your API key. Connect it once and ask your agent things like “Beastify this draft and make a meme for it”.

improve_postAnalysis + 3–4 rewrites (optionally with a meme)
transform_postShorter / hook / human / funnier / angle
search_memesFind templates by keywords
get_meme_templateCaption fields with descriptions and examples
generate_memeRender a template (JPEG or MP4)
suggest_memePick + caption + render for a post
claude mcp add --transport http beastify https://beastify.xyz/mcp \
  --header "Authorization: Bearer bst_…"

Agent skill

A ready-made SKILL.md that teaches agents when and how to use Beastify over the REST API (no MCP needed). Save it in your agent's skills folder and export your key.

Install
mkdir -p ~/.claude/skills/beastify
curl -o ~/.claude/skills/beastify/SKILL.md https://beastify.xyz/skill/beastify/SKILL.md
export BEASTIFY_API_KEY=bst_…

Errors

Errors return a non-2xx status and {"error": {"code": "…", "message": "…"}}. The message is written for humans; switch on the code.

StatusCodeMeaning
400POST_TOO_LONG · EMPTY_POST · INVALID_INPUTS · INVALID_TRANSFORMFix the request; the message says what's wrong.
401MISSING_API_KEY · INVALID_API_KEYMissing, wrong or revoked key.
402PRO_REQUIREDThe key's account isn't on Pro.
404MEME_NOT_FOUND · NOT_FOUNDUnknown template handle or endpoint.
502 / 504LLM_MALFORMED · LLM_TIMEOUTThe AI hiccuped. Retry once.
503LLM_UNAVAILABLE · DATABASE_UNAVAILABLETemporary outage. Retry shortly.