AxiomCode Try free

REST & MCP API

Built for agents first. Humans welcome.

Base URL

https://api.axiom-code.com

Authentication

Paid endpoints take an API key in the X-API-Key header. Keys are issued after any credit purchase. Trial endpoints take an email address and are limited to 10 verifications with no certificates.

REST endpoints

Method & pathAuthWhat it does
POST /v1/trial/verifyemailVerify a Lean artifact. Returns verdict + transcript. No certificate. 10 lifetime uses per email.
POST /v1/verifyAPI keyVerify and, on pass, issue a signed certificate. Metered by compute time.
GET /v1/check?serial=...noneCertificate status: VALID / REVOKED / EXPIRED, with reason.
GET /v1/revokednoneThe public revocation list.
GET /v1/accountAPI keyCredit balance and usage report.

Example: trial verification

curl -X POST https://api.axiom-code.com/v1/trial/verify \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com",
       "code":"theorem add_comm_nat (a b : Nat) : a + b = b + a := by\n  exact Nat.add_comm a b"}'
# {"verdict":"PASSED","compute_seconds":11.8,"credits_charged":0,
#  "trial_remaining":9,"certificate":null,
#  "note":"Trial verdicts carry no certificate."}

MCP server

Endpoint: https://api.axiom-code.com/mcp (streamable HTTP). Tools:

ToolWhat it does
verifySubmit a Lean artifact; returns verdict, transcript, and (paid) certificate.
check_certificateValidate a certificate by serial.
pricingCurrent credit price and pack list.
usage_reportMetered usage for your API key.
Agent pattern: after your coding agent finishes a safety-critical function, have it write the Lean spec and call verify. Ship the certificate with the code — your user can check it without trusting your agent.

Metering

Compute time is metered at 0.9 credits/second (1 credit = US$0.01). Every response includes compute_seconds and credits_charged. Meter records are append-only and tamper-evident; your usage_report always reconciles.

Rate limits & abuse

  • Trial: 10 verifications per email, lifetime; 1 concurrent request.
  • Paid: 5 concurrent verifications per key by default; contact us for more.
  • Submissions are capped at 2 MB of source; engine time is capped per call.
  • We may suspend keys used to probe the engine adversarially or to resell trial access. See the Terms.