Using the BookLive MCP Server to Manage Your Account with AI

BookLive’s MCP (Model Context Protocol) server lets you connect AI assistants — such as Claude Desktop or any other MCP-compatible client — directly to your BookLive account. Once connected, you can ask your AI assistant to look up performances, manage clients, build timelines, send proposals, enroll workflows, and much more, all without leaving your AI tool’s interface.

This article walks you through how the MCP server works, how to connect it, and what you can do with it. To learn how to generate the API token you’ll need, see Managing API Tokens in BookLive.

Before You Begin #

• You must have an active BookLive Pro subscription — the MCP server is a Pro feature.
• You must be a group leader on at least one group.
• You need a valid API token. See Managing API Tokens in BookLive to generate one.
• You need an MCP-compatible AI client. Claude Desktop is the most common, but any client that supports the MCP standard works.

Step 1: Find the MCP Server URL #

BookLive’s MCP server endpoint is:

https://booklive.com/mcp

You’ll enter this URL when configuring your AI client.

Step 2: Configure Your AI Client #

Configuration varies by client. For Claude Desktop:

1. Open Claude Desktop and go to Settings.
2. Click Developer in the left sidebar, then click Edit Config.
3. Add a new entry under mcpServers:

{
  "mcpServers": {
    "booklive": {
      "url": "https://booklive.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

4. Replace YOUR_API_TOKEN_HERE with the token you generated in BookLive.
5. Save the file and restart Claude Desktop.

Once connected, you’ll see a BookLive tool indicator in Claude Desktop’s interface. Your AI assistant can now access your BookLive data.

What You Can Do with the MCP Server #

The BookLive MCP server exposes a broad set of tools covering nearly every area of the platform. Here’s an overview by category:

Performances #

• List upcoming and past performances
• Get full performance details (timeline, musicians, payments, contracts)
• Create new performances
• Check group availability for a date

Timeline Management #

• Create a timeline block — add a new event block (e.g. Prelude, Ceremony, Cocktail Hour) with a name, start time, and duration
• Update a timeline block — change the name, start time, duration, or TBD status of an existing block
• Delete a timeline block — soft-delete a block and its song placements (songs remain in your repertoire)
• Add songs to a block, remove songs from a block, and reorder songs within a block

Clients and Contacts #

• List, search, and view clients
• Create clients and update their information
• Add notes, tags, and tasks to client records
• View client email history

Proposals, Contracts, and Payments #

• Create and send proposals
• Create and send performance contracts
• Add and manage line items and discounts

Song Library #

• List and search your song catalog
• Create, update, and delete songs
• Merge duplicate songs
• Add song attachments and scores

Workflows and Automation #

• List and view workflows
• Enroll performances, partnerships, and event opportunities in workflows
• Pause, resume, or cancel workflow enrollments
• View workflow enrollment snapshots and step progress

Gig Vault (Partnerships) #

• Add prospects and create partnership records
• List and search partnerships
• Add contacts, tasks, and notes to partnerships
• Enroll partnerships in workflows and update their status

Event Opportunities #

• Browse and filter event opportunities
• Add events to your Pitch List
• Update pitch status and notes
• Manage contacts and workflow enrollments on pursuits

Broadcasting #

• Create, preview, and schedule email broadcasts
• Cancel or update scheduled broadcasts

Example: Building a Timeline with AI #

Once connected, you can ask your AI assistant to help build a performance timeline in natural language. For example:

“Create a timeline for my June 14th wedding performance. Add a Prelude block starting at 4:00 PM for 30 minutes, a Ceremony block at 4:30 PM for 45 minutes, and a Cocktail Hour block at 5:15 PM for 60 minutes.”

Your AI assistant will use the BookLive MCP tools to look up the performance, create each block in sequence, and confirm the result — all without you switching tabs or navigating the app manually.

Tips & Notes #

• Tokens act as you. Any AI client holding your token can perform actions on your behalf. Store tokens securely and revoke any you no longer need from the API Tokens tab in Account Settings.
• MCP tools require Pro. If your subscription lapses, MCP tools will return authorization errors until your plan is active again.
• Soft-deletes are reversible. Deleting a timeline block via MCP soft-deletes it — it can be restored from the BookLive web interface if needed.
• Timeline blocks auto-sort by start time. When creating blocks, BookLive automatically orders them by their start time, so you don’t need to worry about insertion order.
• Songs stay in your library. Removing a song from a timeline block or deleting the block entirely does not remove the song from your group’s repertoire — only its placement in that specific block is affected.

Related Articles #

• Managing API Tokens in BookLive
• Building a Performance Timeline in BookLive
• Creating and Managing Workflows in BookLive