biblioplex

integrations / field guide

One collection. Every surface.

Use Biblioplex from an AI assistant over MCP or from your terminal with the bp command. Both work against the same live collection as the web app.

01

model context protocol

Connect an AI assistant over MCP

Biblioplex exposes a remote HTTP MCP server with OAuth. Add the endpoint, sign in, and choose whether the client can only read or can also preview and apply changes.

remote MCP endpoint https://biblioplex-api.bensonperry.com/mcp
  1. Add the endpointUse the client-specific instructions below.
  2. Complete OAuthSign in to Biblioplex when the browser opens.
  3. Grant a scopeStart with collection.read; add collection.write only when you want edits.
  4. Name Biblioplex in your promptAsk the assistant to use the Biblioplex MCP tools directly.
ChatGPT

Developer Mode

  1. Enable Developer Mode in ChatGPT settings.
  2. Create an app using the remote MCP endpoint above.
  3. Choose OAuth, sign in, then enable the Biblioplex app in a conversation.

“Use Biblioplex tools directly. Show my ten most valuable foil cards.”

Codex

Config file

Add this server, then follow the OAuth prompt:

[mcp_servers.biblioplex]
url = "https://biblioplex-api.bensonperry.com/mcp"

“Use the Biblioplex MCP server. List my deck containers.”

Claude Code

One command

Add the HTTP server, then run /mcp and complete OAuth.

claude mcp add --transport http biblioplex \
  https://biblioplex-api.bensonperry.com/mcp
Generic clients

Standards-based discovery

Compatible clients can discover protected-resource metadata, authorization, dynamic registration, PKCE, and the available scopes from the Biblioplex server.

collection.read · collection.write

What agents can read

Collection summaries, inventory, containers, decks, recent changes, search, and individual result details.

How writes work

The client previews a change, shows it to you, then applies the same revision only after confirmation.

How to recover

Every successful MCP write gets a server-side recovery point, plus a quick undo path for the latest safe change.

02

command-line interface

Install the bp command

Search, edit, import, export, and recover from a terminal. Use it interactively or add --json for stable, script-friendly output.

npm · requires Node.js 22+ 
npm install -g biblioplex
homebrew 
brew install benson/tap/biblioplex
quick start 
$ bp login
# opens a browser; read-only by default

$ bp summary
428 unique · 615 total · $3,842.19 · 12 containers

$ bp search "finish=foil order by price desc" --limit 10
# add --json for scripts and agents

$ bp login --write
$ bp search "name=Sol Ring" --json
$ bp move "<itemKey>" --to "container:commander staples"
# shows a dry-run preview before applying
readsummary search ls deck value prices history resolve
writeadd rm move edit import export
recoverundo recover
authlogin logout whoami

Interactive authentication

bp login uses browser OAuth with PKCE. Add --write when you need mutation commands.

Headless authentication

Create a personal access token from the Biblioplex account menu, then set BIBLIOPLEX_TOKEN.

Preview every write

Use --dry-run to stop after preview or --yes to approve non-interactively. Recovery points still apply.

ready when you are

Start with the app. Add a surface whenever you need it.

open biblioplex back to the feature tour