Developer Tools

Fix PDFs from anywhere

REST API, CLI, MCP, or drop into your AI coding workflow. One API key, all channels.

Quick Start

Three steps. Under a minute.

Get your API key

Request access and receive your key instantly.

Request API key

Set your environment

export ADA_API_KEY=sk_...

Fix your first PDF

ada-fix report.pdf

REST API

Submit, poll, download. API keys are scoped to one organization.

# Submit a PDF
curl -X POST https://ada.appalach.info/api/quick-fix/upload \
  -H "Authorization: Bearer $ADA_API_KEY" \
  -F "file=@annual-report.pdf"

# Response: {"jobId": "j_abc123"}

# Check status
curl https://ada.appalach.info/api/quick-fix/jobs/j_abc123 \
  -H "Authorization: Bearer $ADA_API_KEY"

# Response: {"status": "completed", "pages_processed": 12, "remaining_issues": 0}

# Download fixed PDF after completion
curl -L -o annual-report_fixed.pdf \
  https://ada.appalach.info/api/quick-fix/jobs/j_abc123/download \
  -H "Authorization: Bearer $ADA_API_KEY"

CLI Binary

Single binary, zero dependencies. macOS, Linux, Windows.

Installation

# macOS (Apple Silicon)
curl -L https://ada.appalach.info/cli/ada-fix-darwin-arm64 -o /usr/local/bin/ada-fix
chmod +x /usr/local/bin/ada-fix

# Linux
curl -L https://ada.appalach.info/cli/ada-fix-linux-amd64 -o /usr/local/bin/ada-fix
chmod +x /usr/local/bin/ada-fix

Usage

# Fix a single PDF
ada-fix annual-report.pdf
# Fixed: annual-report.pdf -> annual-report_fixed.pdf (12 pages, 7 issues resolved)

# Fix an entire directory
ada-fix batch ./public-pdfs/
# [1/24] Processing budget-2024.pdf... done
# [2/24] Processing meeting-minutes.pdf... done
# ...
# Done: 24/24 PDFs fixed successfully

# Check your usage & tier
ada-fix usage
# Tier: 2 ($3.00/PDF) | Lifetime: 127 docs | Credits: 43 remaining

MCP (Model Context Protocol)

Let your AI assistant fix PDFs directly. Works with Claude Desktop, Cursor, and any MCP-compatible client.

Configuration

{
  "mcpServers": {
    "ada-pdf-fix": {
      "command": "ada-fix",
      "args": ["mcp-serve"],
      "env": {
        "ADA_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Example interaction

You: Fix all the PDFs in ~/Documents/reports/ for accessibility

Claude: I'll fix those PDFs for Section 508 verification...
       [1/5] quarterly-report.pdf -> 7 issues fixed
       [2/5] budget-summary.pdf -> 3 issues fixed
       ...
       All 5 PDFs passed Section 508 verification.

Claude Code & Codex

Drop into your AI coding workflow. Fix PDFs as part of your build process.

Claude Code

# In Claude Code
> Fix all PDFs in the public/ directory for Section 508 compliance

# Claude Code uses ada-fix automatically:
Finding PDFs in public/... found 12 files
Fixing public/annual-report.pdf... done (7 issues)
Fixing public/policy-manual.pdf... done (15 issues)
...
All 12 PDFs fixed. Total issues resolved: 47

CI/CD Integration

# GitHub Actions example
- name: Fix PDFs for accessibility
  run: |
    curl -L https://ada.appalach.info/cli/ada-fix-linux-amd64 -o ada-fix
    chmod +x ada-fix
    ./ada-fix batch ./public/docs/
  env:
    ADA_API_KEY: ${{ secrets.ADA_API_KEY }}

Email

No code required. Send a PDF, get it back fixed.

To: fix@appalach.info
Subject: Fix this PDF
Attachment: budget-report.pdf

-> Reply (2 minutes later):
  Attachment: budget-report_fixed.pdf
  "Your PDF passed Section 508 verification. 7 issues fixed."

One credit balance. Every channel.

All channels use the same credit balance. Buy packs, use credits across any channel.

$3.90 $3.50 $2.80 $2.20

Larger credit packs = lower per-PDF cost.

See full pricing breakdown

Ready to integrate?

One API key works across REST, CLI, MCP, and email. Start fixing PDFs in under a minute.

Get your API key See pricing