Slima MCP

Query book schema with the resource

Lectura de 4 min

MCP isn't only tools — it has resources too. The schema resource is a key one: tells AI a book's exact permissions.

Slima Authorized Apps: MCP clients querying schema resource for precise permissions appear here

How to use

Resource URI: slima://books/{book_token}/schema

MCP-capable clients can read resources directly — no tool call needed.

# Pseudo-code (depends on the client's resource API)
schema = read_resource("slima://books/bk_xxx/schema")

What it returns

{
  "book_token": "bk_xxx",
  "book_type": "script",
  "writable_paths": [".script_studio/planning/**/*"],
  "readonly_paths": [
    "*.scene",
    "*.character",
    "*.storyline",
    "*.note",
    "*.location",
    "series.json",
    "season.json",
    "episode.json",
    ".script_studio/planning/.initialized"
  ],
  "structured_extensions": [".scene", ".character", ".storyline", ".note", ".location"],
  "search_excludes_structured_by_default": true
}

Why this resource exists

Writing a *.scene will fail (400) — but calling schema first lets you know in advance the path is read-only, no wasted API call.

Recommended AI workflow

1. list_books → get book_token
2. read_resource(slima://books/{token}/schema) → get rules
3. Plan reads / writes safely given the rules
4. Execute

MCP-capable clients (Claude / Cursor) auto-expand resources to the AI — the AI doesn't need to explicitly call.

Writing Studio book schema

{
  "book_token": "bk_xxx",
  "book_type": "book",
  "writable_paths": ["**/*"],
  "readonly_paths": [],
  "structured_extensions": [],
  "search_excludes_structured_by_default": false
}

Simple — all paths writable, nothing structured.

Related

Was this helpful?