Share — TinyTales MCP

tinytales_share books:read

Read a book’s invite link, list collaborators, or preview an invite without joining. Actions: get, collaborators, preview_join.

Actions: get, collaborators, preview_join.

01Access

The signed-in customer must have approved books:read. Calls stay inside that account.

readOnlyHint

true

The tool only loads data that already belongs to the signed-in account.

destructiveHint

false

The change can be removed later with tinytales_delete, or it only adds data.

openWorldHint

false

This tool only reads or changes the signed-in TinyTales account. It does not post to the public internet or to other people’s services.

idempotentHint

true

Repeating the same call does not stack a second effect.

action

string · required

Which action to run: get, collaborators, preview_join.

book_id

string

Book id for get or collaborators.

token

string

Invite token from the share URL for preview_join.

response_format

string

json returns structured data. markdown returns the same data as a short readable summary. Defaults to json.

boolean · required

True when the underlying TinyTales route accepted the call.

summary

string · required

One-line result for the model to read.

error

string

Present when ok is false. Names the failed state and the next action to call.

total_count

integer

Number of collaborators returned.

{
  "action": "get",
  "book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

{
  "ok": true,
  "summary": "Share link is active."
}