Command line · same key as the API
The filings CLI
The same answers as the MCP tools, from a terminal. Built for agents with a shell (Claude Code, Codex): compact text output, so an answer costs fewer tokens than the same answer over MCP. Python 3.9+, no dependencies.
Install
One command
Key: set FILINGS_API_KEY, or put it in ~/.config/filings/key. The CLI calls the REST API with that key.
pipx install https://filings-api.fly.dev/cli/filings_cli-0.1.0-py3-none-any.whl # or uv tool install https://filings-api.fly.dev/cli/filings_cli-0.1.0-py3-none-any.whl # or one file, no install curl -O https://filings-api.fly.dev/cli/filings.py && python3 filings.py --help
Commands
The answer first
Lists come as one table with the header once. --json gives compact JSON.
Yes. Stripe, Inc. had 294 certified H-1B LCAs (294 positions) in the last four quarters ... verdict: sponsors company.scope_id: emp_us_stripe_inc data_window.period: last_4_quarters top_titles.rows (5): job_title|cases|share ...
filings check Stripe --role "data engineer" --location "Seattle, WA" filings offer "data scientist" "Austin, TX" 145000 --company Dell filings rank --role "data engineer" --metro "bay area" --limit 5 filings trends --employer-query Google --mode by_year filings wages --employer-query Microsoft --role "product manager" filings cases --employer-query EY --petition-type change_employer --limit 1 filings identify "Gogle" filings case I-200-... filings releases filings cite filings <command> --help (--json for compact JSON)
For agents
The skill
A short instruction that tells an agent which command answers which question. For Claude Code, save it as a skill. Other agents (Codex and the like): add the same text to AGENTS.md or the system prompt.
mkdir -p ~/.claude/skills/filings-cli curl -o ~/.claude/skills/filings-cli/SKILL.md https://filings-api.fly.dev/cli/SKILL.md
CLI or MCP?
An agent with a terminal: the CLI (fewer tokens per answer). A chat app or IDE without a shell: the MCP server. Same data, same answers.
Data, not advice
OFLC public disclosure data, determined cases only, through FY2026 Q3. An LCA is not a USCIS H-1B approval.