---
id: 78c597d0-51ac-459c-9d2d-b785f3fcd362
type: decision
title: "Paper Dynasty card-creation needs a dedicated API query CLI tool"
tags: [paper-dynasty, cli, tooling, future-work, card-creation]
importance: 0.7
confidence: 0.8
created: "2026-02-22T15:44:17.612480+00:00"
updated: "2026-02-22T15:44:17.612480+00:00"
---

# Paper Dynasty Card-Creation: Missing API Query CLI

## Context

The `card-creation` project has a `pd-cards` CLI for card generation workflows, but lacks a general-purpose API query tool for interacting with the Paper Dynasty API directly (listing players by cardset, filtering, inspection, validation, etc.).

## Problem

Currently all API queries go through raw Python calls via `db_calls.py`, which is error-prone. In at least one session, this led to using the wrong query parameter name (`cardset` instead of `cardset_id`), causing silent failures that returned 13,500+ unfiltered records.

## Comparison

Major Domo has a mature CLI at `~/.claude/skills/paper-dynasty/cli.py` (the `paperdomo` command) that handles auth, output formatting, and error handling well. The PD card-creation project has no equivalent.

## Decision / Future Work

Build out a dedicated CLI for PD card-creation API operations:
- Player queries by cardset, description, name
- Cardset inspection and validation
- General API debugging utilities

This should be added to the `pd_cards/` CLI package or as a new standalone skill.

## Tags
paper-dynasty, cli, tooling, future-work