# Tome (AI Storytelling) MCP

> Tome (AI Storytelling) lets your agent build and manage entire presentations using natural conversation. Connect it to generate storyboards, create new project decks in specific workspaces, and add pages to existing narratives without ever opening the web app. It makes AI-driven content creation conversational and hands-free.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** storytelling, presentations, ai-content, content-creation, workspace-management

## Description

Stop clicking through slide templates and manually assembling projects. This MCP connects your preferred AI client directly into Tome, turning storyboarding from a multi-tab ordeal into a simple conversation with your agent. Your AI acts as the creative director, handling all the background work. Need to start fresh? The agent can list available workspaces so you know exactly where your content lives. Want to build out an existing project? You can ask your agent to create a brand new tome in a specific spot or add detailed pages directly into a narrative structure. This capability means you manage complex storytelling projects entirely from your chat window, using Vinkius as the gateway to the full catalog of services.

## Tools

### add_page
Adds a specified page of content directly into an already created tome structure.

### create_tome
Generates a new, empty presentation deck (tome) inside a selected workspace.

### get_tome
Pulls comprehensive data about one specific tome, showing its current pages and metadata.

### list_tomes
Retrieves a list of all existing tomes contained within the currently targeted workspace.

### list_workspaces
Fetches and displays a complete inventory of available Tome workspaces connected to your account.

## Prompt Examples

**Prompt:** 
```
List all my Tome workspaces.
```

**Response:** 
```
I've retrieved your workspaces. You have access to: 'Personal Space' (ID: ws_987) and 'Design Team' (ID: ws_654). Which one would you like to explore?
```

**Prompt:** 
```
Create a new tome titled 'Product Roadmap 2025' in workspace ws_987.
```

**Response:** 
```
Successfully created! Your new tome 'Product Roadmap 2025' is now live in your Personal Space with ID: tome_abc123. Would you like to add the first page?
```

**Prompt:** 
```
Add a page called 'Market Analysis' to tome tome_abc123.
```

**Response:** 
```
Done. I've added the 'Market Analysis' page to your tome. You can now see it in the presentation structure.
```

## Capabilities

### List available workspaces
Retrieves all connected Tome workspaces so you know where to start building content.

### Create new presentation projects (tomes)
Builds a brand new story or presentation deck within a specific workspace.

### Get details on a tome
Fetches the full structure and metadata for an existing project, letting you see what's already in place.

### List all tomes in one workspace
Provides an overview of every presentation deck currently stored within a selected workspace.

### Add pages to existing stories
Expands your narrative by adding new, specific pages to any active tome structure.

## Use Cases

### Drafting a new product roadmap
A Product Manager needs to outline 'Product Roadmap 2025.' They ask their agent to create a tome titled 'Product Roadmap 2025' in the main company workspace. The MCP handles the creation and gives them immediate confirmation, letting them start adding content right away.

### Updating an existing client pitch
A Marketing Manager has a pitch deck that needs a deep dive on competitor analysis. Instead of opening the file, they ask their agent to add pages with 'Market Analysis' data to the specific tome ID, updating the presentation structure in one go.

### Organizing client assets
A Content Creator has dozens of projects across different clients. They first use the MCP to list all accessible workspaces, instantly sorting through their accounts and picking the correct container for a new story.

### Reviewing project scope
Before collaborating on a deck, an agent uses `get_tome` to pull detailed information about the presentation's structure. This lets them check if all required sections are present before starting any writing.

## Benefits

- Start fresh decks instantly. You can use the `create_tome` tool to generate new project storyboards in a specific workspace with simple instructions.
- Expand existing content dynamically. If your narrative needs more detail, you just ask your agent to add pages using the `add_page` function.
- Never lose track of projects again. The MCP lets you list all available workspaces first, so you always know where every deck lives.
- Inspect project details fully. Use `get_tome` when you need to pull complete metadata on a specific presentation to check its structure before making changes.
- Manage your assets efficiently. You can use the agent to list all tomes in a workspace, giving you an immediate inventory of everything created.

## How It Works

The bottom line is that your agent handles all the API calls so you just talk through your presentation plan.

1. Subscribe to this MCP and provide the required Tome API key within Vinkius.
2. Tell your agent what you need. For example, 'Start a new roadmap for Q3' or 'Add market analysis pages to my existing deck'.
3. Your AI client executes the commands using the available tools and returns confirmation of the successful action.

## Frequently Asked Questions

**How do I list all my workspaces using Tome (AI Storytelling)?**
You ask your agent to use the `list_workspaces` tool. It will retrieve a complete inventory, allowing you to select the correct container for your project before doing anything else.

**Can I add pages to an existing tome using Tome (AI Storytelling)?**
Yes, use the `add_page` function. You simply tell your agent which tome and what content you want added, letting it handle the page insertion.

**What if I need to start a completely new presentation deck?**
Use the `create_tome` tool. Just specify the title and target workspace, and your agent handles generating the empty project for you.

**Does Tome (AI Storytelling) MCP only work with one type of content?**
No. It manages tomes that can hold various types of narrative data, allowing you to build everything from product roadmaps to marketing campaigns.

**How do I check the details of a specific tome?**
Use `get_tome`. This tool pulls all the detailed metadata and structural information for one presentation deck, letting you verify its contents before making changes.