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 ($2.50/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. Same lifetime volume pricing.

$4.00 $2.50 $1.50 $1.00

Price per PDF drops as your lifetime volume grows.

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