Skip to content
AvFees

API & MCP

One REST API, described in OpenAPI 3.1 and exposed as MCP tools. The spec is at /api/openapi.json and the MCP manifest is at /api/mcp-manifest.json.

Authentication

Send your key as a bearer token. Keys start with ffe_.

curl "https://avfees.com/api/v1/fees?icao=CYSB&aircraft_class=turboprop" \
  -H "Authorization: Bearer ffe_..."

Operations

POST/api/v1/feesMCP tool report_fee

Report one observed fee line. Earns credits once validated (more for FBOs with no recent data; 0 for a duplicate).

Requires a key cleared to contribute (scope fees.contribute, which needs operator consent); otherwise 403 consent_required. Contributed lines are credited at once but stay visibility=pending_consent (not returned by any lookup) until published.

GET/api/v1/feesMCP tool lookup_fees

Look up fees at an airport for an aircraft class. Costs 1 credit per FBO returned (free when nothing is found); subscription keys are unlimited and also get labeled projections for fee types with no fresh observation.

ParameterRequiredNotes
icaoyes
aircraft_classyespiston, turboprop, light_jet, midsize_jet, super_midsize_jet, heavy_jet, airliner
fbonoLimit to one FBO. Needed for projections.
fee_typenohandling, ramp, facility, landing, terminal, parking, overnight, gpu, lav, water, deice, hangar, security, callout, navigation, fuel_surcharge, other
POST/api/v1/invoicesMCP tool submit_invoice

Submit an FBO or airport invoice (PDF, base64). It is parsed into fee lines with every identifying detail dropped; credits are awarded once validated. Re-submitting the same invoice credits 0.

Requires a key cleared to contribute (scope fees.contribute, which needs operator consent); otherwise 403 consent_required. Contributed lines are credited at once but stay visibility=pending_consent (not returned by any lookup) until published.

GET/api/v1/creditsMCP tool credit_balance

The calling key's credit balance and tier.

Errors

API & MCP | AvFees