Examples, write

Save example

Keep a post someone else wrote as an example of a shape worth copying: the link, the text and whatever the page showed beside it. A run reads examples as shapes and never as sentences, so nothing here is ever quoted back. Nothing is fetched, no model runs, and it costs nothing.

write

MCP

Tool namesave_example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save_example",
    "arguments": {
      "project_id": "<uuid>",
      "link": "<string>",
      "text": "<string>"
    }
  }
}

Input

project_idrequireduuid
linkrequiredstring

A link to the post on X, Bluesky or Hacker News, whose platform and author are read off it, or any https link when platform and author_handle are sent too.

textrequiredstring

The post as it reads, up to 2000 characters. Nothing is fetched to find it.

series_iduuid

Keep it for one series rather than the project's own pool. Left out is the pool.

notestring

One line in the person's own words about why the post works, up to 280 characters. "The hook is a number, the last line is a question."

platformstring

Where it was posted. Only read when the link is not one Sonket's parser knows.

author_handlestring

Who posted it. Only read when the link does not name them.

author_namestring

Their display name, as the page drew it.

avatar_urlstring

A link to their picture, https.

posted_atstring

When it went out: an ISO instant, or YYYY-MM-DD in the project's timezone.

repliesinteger

How many replies the post had when you read it.

repostsinteger

How many reposts the post had when you read it.

likesinteger

How many likes the post had when you read it.

viewsinteger

How many views the post had when you read it.

cutboolean

The page showed the post truncated, so the text is short of it. complete_example finishes it with one X read.

mediaarray of { type, url, poster }

The pictures on the post, at most four kept. A video's url is its poster frame.

quoted{ handle, name, text, url }

The post it quotes, kept as a card under it and never a row of its own.

sourceextension | paste | screenshot

Which door it came through: the browser extension, or a paste. Paste by default.

Returns

The example's id, whether the same link was already saved in this project, whether that second save raised its counts or filled a blank, and a link to the page it is listed on.