Documentation
Tool catalogue
Twelve tools, not one more. Nine read or write your draft, one publishes and two report back. What is not on this list cannot be asked for, because it does not exist on the server.
The twelve tools
| Tool | Mode | Weight | What it does |
|---|---|---|---|
| list_pages | Reads | 1 | The pages the token reaches, with their state and their link. |
| get_page | Reads | 1 | The whole draft: header, groups, blocks and appearance. |
| list_block_kinds | Reads | 1 | The catalogue of block types, variants and layouts that validate. |
| add_block | Writes | 5 | Adds a validated block to a group. |
| update_block | Writes | 5 | Changes the content of a block. |
| remove_block | Writes | 5 | Deletes a block. |
| reorder_blocks | Writes | 5 | Reorders the blocks of a group. |
| set_appearance | Writes | 5 | Saves the appearance against its closed schema. |
| preview_page | Reads | 1 | A preview link for the draft, before anything is published. |
| publish_page | Writes | 10 | Publishes the page. Only with the publish scope. |
| get_stats | Reads | 1 | Visits and clicks for a period. |
| list_proposals | Reads | 1 | Your inbox, wrapped and marked as third-party text. |
The text in your inbox was written by other people. list_proposals hands it over marked as data, never as an instruction, so an assistant reading your messages does not do what they say.
How the weight works
Every call spends its weight from the quota of the day. Reading costs one, writing costs five and publishing costs ten, so a long conversation that only reads barely moves the counter. Your panel shows how much of today you have spent.
Errors that teach
A rejected call never answers with a flat no. It comes back with the options that would have been accepted, and that is what lets an assistant correct itself on the next turn instead of guessing.