Docs

Documentation

Plug Spine into your terminal, your agent, and your AI.

Spine exposes two interfaces beyond the mobile app: a command-line tool for readers who live in their terminal, and a Model Context Protocol server so AI agents like Claude Desktop, Cursor, and Goose can manage your bookshelf, pull recommendations, and talk to your reading companion on your behalf.

CLI

Search, shelve, rate, and get recommendations from any terminal. Thirty commands, one API key, no frontend required.

Read the CLI docs →

MCP Server

Give your AI agent access to your shelf. Thirty-six tools exposed over the Model Context Protocol — works with Claude Desktop, Cursor, Goose, and any MCP client.

Read the MCP docs →

Start here: get an API key

Both the CLI and the MCP server authenticate with a single Spine API key — one per user. You'll need a Spine account (currently iOS beta) to generate one.

  1. Open Spine on your phone and go to Settings → API Key.
  2. Tap Generate. Your key starts with sk_spine_ and is shown once.
  3. Copy it to ~/.spine.json (for the CLI) or your MCP client config.
!
How the key works. It acts as you — same access as your mobile session, no scopes. You can only have one active key at a time, and generating a new one rotates the old. Revoke anytime from Settings → API Key.

Already have one? Jump straight to the CLI docs or MCP docs.

A quick note on beta

Both the CLI and MCP server talk to the same Fly-hosted API that powers the mobile app. Expect rough edges. If you hit a bug or the ergonomics feel wrong, let us know in Discord — we move fast on feedback.