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.

terminal
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.

filings check Stripe · decisions Jul 2025 – Jun 2026
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
  ...
commands
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.

terminal
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.