ToolsInstallSafetyBuildConverter
Build your PCM database, assisted by AI agents

Open up your Pro Cycling Manager database

Read and edit any Pro Cycling Manager database by asking an AI assistant: rosters, startlists, rider ratings changed in plain language.

One file to open, no .exe to run, nothing to type. Just want a .cdb as SQLite? Use the browser converter.

AI assistant

List my Pro Cycling Manager 2025 saves.

pcm_list_saves3 careers

Newest first: 2029 season with Decathlon–CMA CGM, then two 2028 careers.

Who's the best climber in my team?

pcm_get_team_roster28 riders

Paul Seixas, 20. The highest mountain rating in your roster, and he still has three years of contract.

mountain 84hill 80OVR 82

Raise his mountain rating to 88.

pcm_update_cyclist_ratingsnew database

Mountain 84 to 88, written to a fresh file: career-2029-edited.cdb. Your original database is untouched.

mountain 88OVR 84
reads + edits.cdb databasesyour original file is never touchedrunson your own PC
12
Toolsyour assistant can use
5
PCM versions tested2014 to 2025
MIT
Licensedfree forever
// in plain language

What you can ask

No query language to learn. You type the question, the assistant picks the tool and reads your database.

List my Pro Cycling Manager 2025 saves.

pcm_list_saves

Who's the best climber in my team?

pcm_get_team_roster

Show me the roster of Decathlon–CMA CGM.

pcm_search_team

Which riders are out of contract next year?

pcm_query_save

Build the startlist for the Tour from these eight teams.

pcm_generate_startlist_xml

Raise Paul Seixas' mountain rating to 84.

pcm_update_cyclist_ratings
// get started

Three ways in

Add our plugin from your AI app and it stays up to date on its own. Or download the Claude Desktop install file, quicker still to set up. Failing that, grab the config file that covers every other client.

Add the PCMStack marketplace once from your app’s own settings, then install the DB Editor plugin from the list.

  1. 1Open your app’s plugin settings: Customize then Plugins in Claude, Settings then Plugins in ChatGPT.
  2. 2Choose Add marketplace and paste the repository address below.
  3. 3Install the DB Editor plugin from the list, then restart the app.

Works in Claude and in ChatGPT, in their desktop apps and on the web. Everything the plugin installs is MIT-licensed and its source is public. What the plugin adds ›

Requirements
Node.js
22 or later, not needed for the Claude Desktop install
A database
any PCM .cdb: a career save, an official release, a community update
Finding your saves

Auto-discovery looks in the game’s Cloud folder on Windows. Anywhere else, pass an absolute .cdb path and everything works the same.

// no, it will not eat your career

Your database is safe

Read-only by default

Every call re-reads the .cdb from disk into an in-memory SQLite database. Ten of the twelve tools can only read, so your client can auto-approve them without asking you each time.

Edits write a new file

The two write tools serialize their changes to a fresh .cdb at a path you choose, and refuse to overwrite the input or any existing file. Your original database stays exactly as it was.

Nothing leaves your machine

No account, no upload, no telemetry. The server runs locally, next to your own .cdb files, and every line of it is MIT-licensed and public.

Still, keep a backup of the database you care about. Good practice with any modding tool.

// no assistant required

Convert a database right now

Drop a .cdb in your browser and get a SQLite file you can open in any SQL tool, then convert it back when you are done. Nothing to install, nothing uploaded.

Convert a .cdb to SQLite

Prefer a terminal? npx cdb-converter database.cdb does the same thing.

// the stack

Tools for the peloton

Read the source
AI TOOLS

pcm-mcp

Read and edit any PCM database in plain language, from Claude, ChatGPT or Gemini. Riders, ratings, rosters and startlists, with every edit written to a new file.

12 toolsread-only SQLstartlist XML
LIB

cdb-converter

Turn a PCM .cdb file into a real SQLite database, edit it in any SQL tool, and convert it straight back. The round-trip loses nothing: same tables, same columns, same rows.

CDB ↔ SQLitelossless round-tripbrowser + node
Planned

editor

A web editor for your PCM database: browse tables, tweak ratings, export a fresh .cdb. In design, nothing to install yet.

in-browserspreadsheet viewsafe exports
// for developers

Build on it

cdb-converter is the layer underneath pcm-mcp, and it is a plain npm package. If you want your own tool, start here rather than at the binary format.

cdb-converter on npm

Two functions, both directions

cdbToSql(buffer, SQL) hands you a sql.js Database. sqlToCdb(db) hands back a compressed CDB ArrayBuffer. Compression is handled for you in both directions.

Optional relational schema

Pass normalize to reconstruct PRIMARY KEY and FOREIGN KEY constraints from the PCM naming conventions, so you can JOIN and draw ER diagrams. Round-trip safe either way.

Isomorphic and small

Runs in Node 22+ and in the browser through sql.js. The library adds ~28 kB of its own code, is TypeScript-first, tree-shakeable, and ships both ESM and CommonJS.

Or just the CLI

No AI assistant involved: convert a .cdb into a SQLite database you can open in any SQL tool, then convert it straight back. The direction is auto-detected from the file extension.

cdb-converter · normalized schema
import initSqlJs from "sql.js"; import { cdbToSql } from "cdb-converter"; const SQL = await initSqlJs(); const db = cdbToSql(cdbBuffer, SQL, { normalize: true }); db.exec(` SELECT c.gene_sz_name, t.gene_sz_name FROM DYN_cyclist c JOIN DYN_team t ON c.fkIDteam = t.IDteam `);
// it will read your database

Compatibility

The CDB parser is format-driven, not version-specific, so it is not tied to a single release. Every version listed here is covered by a lossless cdb to sqlite to cdb round-trip test against the game’s official database.

Pro Cycling Manager versions with a tested round-trip
VersionLossless round-trip
Pro Cycling Manager 2014tested
Pro Cycling Manager 2018tested
Pro Cycling Manager 2019tested
Pro Cycling Manager 2021tested
Pro Cycling Manager 2025tested
// setting it up

Common questions

Do I need Node.js installed?

Not for the Claude Desktop install file: it opens a dialog, you confirm, and that is it. Every other route needs Node.js 22 or later, the plugin included, because the plugin starts pcm-mcp on your machine. So does the cdb-converter command line.

Which AI assistants can run pcm-mcp?

Claude and ChatGPT both install it from our plugin, in their desktop apps and on the web, and Claude Desktop also takes the one-click install file. It runs in the Gemini CLI and anything else that supports the Model Context Protocol too, by adding it to a config file by hand.

Can I open a community database, or only my own career save?

Any PCM .cdb works: a career save, an official Cyanide release, a community update. Nothing in the tools cares where the file came from, and only save auto-discovery is specific to careers, since it looks in the game’s Cloud folder.

Can I edit a database without an AI assistant?

Yes. Convert a .cdb to SQLite in the browser or with npx cdb-converter database.cdb, edit it in any SQL tool, then convert it straight back. Nothing is lost on the way: same tables, same columns, same rows. The rebuilt file is not byte for byte identical, since it is recompressed, so check it by opening it rather than by comparing checksums.

// where we are

Early days, in the open

Two tools shipping, one in design. Everything is MIT-licensed and public, so if something is missing you can open an issue or just build it. Where this goes: building a PCM database assisted by AI agents, you deciding what changes, the agent doing the reading and the editing.

pcm-mcpShipping
v0.3.0

12 tools, save discovery, read-only SQL, guarded edits and startlist export. On npm, and as a one-click install for Claude Desktop.

cdb-converterShipping
v0.4.0

CLI and library, lossless both ways, optional normalized schema, tested against 5 PCM releases.

editorIn design
unreleased

A browser editor built on cdb-converter: see what an agent changed, adjust it by hand, export a fresh database. Nothing to try yet, and it will land here first when there is.

Start building
on your database.

Open the file, confirm the dialog, then ask your assistant to list your saves. No account, no upload: it all runs on your own machine.