Skip to content
For developers

Connect your AI assistant
to the catalogue.

The entire Greenlight Publishing catalogue is available to Claude, ChatGPT, and any other MCP-capable client through the Greenlight MCP server. One endpoint, the open Model Context Protocol, read-only tools.

MCP endpoint
https://www.greenlight.film/api/mcp
Endpoint
1
Tools
18
Catalogues
3
Books
600+
Book tools

What your assistant can do with books.

Four tools cover the book catalogue: browse and search 600+ novels and curriculum titles, pull book detail with author bios, chapter lists, and store links, read free-preview chapters on the free tier, and export complete books on the Growth tier.

list_books
Free

Browse the 600+ published novels and curriculum titles. Filter by genre, author slug, or category (fiction | curriculum). Returns metadata cards with store links.

get_book
Free

Full detail for one book by slug: description, author bio, excerpt, and the chapter list with free-preview flags.

get_book_chapter
Free / Growth

Full text of one chapter. Free-preview chapters are readable on the free tier; all other chapters require the Growth tier.

export_book
Growth

The complete book: metadata, author bio, and every chapter with full text. Large; billed as 5 requests.

The same endpoint also serves the greenlight.film development slate and the greenlight-audio.com audiobook catalogue, plus cross-catalogue search and fetch tools. The full 18-tool reference lives on the greenlight.film API docs.

Setup

Connect in under a minute.

Claude Code

One command in your terminal.

claude mcp add --transport http greenlight https://www.greenlight.film/api/mcp

claude.ai / Claude Desktop

Settings → Connectors → Add custom connector, then paste the endpoint. Claude walks you through the OAuth sign-in; approve access and you're connected.

https://www.greenlight.film/api/mcp

ChatGPT

Settings → Connectors → enable Developer mode → Create connector. Set the MCP server URL and pick OAuth authentication, then sign in when prompted. The server implements the search + fetch contract, so it works with deep research.

https://www.greenlight.film/api/mcp

VS Code / Cursor

Add an HTTP MCP server with the same URL. In VS Code, add it to .vscode/mcp.json; in Cursor, add it to .cursor/mcp.json with your API key as a Bearer header.

// .vscode/mcp.json
{
  "servers": {
    "greenlight": {
      "type": "http",
      "url": "https://www.greenlight.film/api/mcp"
    }
  }
}

// .cursor/mcp.json
{
  "mcpServers": {
    "greenlight": {
      "url": "https://www.greenlight.film/api/mcp",
      "headers": {
        "Authorization": "Bearer gl_pk_your_key_here"
      }
    }
  }
}
Authentication

Two ways in.

OAuth 2.1 + PKCE

Sign in with your account

Hosts like Claude and ChatGPT discover the server via /.well-known/oauth-protected-resource and walk you through sign-in. Approve access once and your tier follows your account's plan. No key handling needed.

API key

Bearer token

For Cursor, scripts, and API integrations: generate a gl_pk_... key on the greenlight.film API docs and send it as a Bearer token.

Authorization: Bearer gl_pk_...
Tiers

What each tier unlocks for books.

TierRate limitBook access
Free10 req/hourBrowse and search the full catalogue, book detail with author bio, chapter list, and store links, free-preview chapter text.
Starter100 req/hourEverything in Free at ten times the rate. Also unlocks audiobook detail plus film reviews and assets on the same endpoint.
Growth1,000 req/hourEvery chapter of every book, plus export_book for complete book text in one call (billed as 5 requests). Also unlocks audiobook chapter audio and full film deliverables.
Enterprise10,000 req/hourEverything in Growth at enterprise rate limits, with priority support.

Keys and plans are managed on greenlight.film — see pricing for plans and the API docs for the full tool and endpoint reference.

Example

One prompt, three tools.

Ask Claude

“Find Greenlight books about survival at sea and read me the free preview chapter.”

01
searchFree tier

The assistant searches the catalogue for “survival at sea”. The search tool matches book titles, descriptions, and genres, and returns result ids like book:{slug}.

02
get_bookFree tier

It pulls the detail for the best match: description, author bio, store links, and the chapter list — including which chapters are flagged as free previews.

03
get_book_chapterFree tier

It fetches the full text of a free-preview chapter and reads it back to you. On the Growth tier it could keep going past the preview — or export_book the whole novel.

Every book, one endpoint away.

Start on the free tier — browse the catalogue, pull book detail, and read free-preview chapters with nothing but a connector URL.