RAREXT Developer Resources

RAREXT exposes a public, no-key API for AI agents and developers — company data, the FAQ-powered AI consultant, and order verification. Everything below is also machine-readable at /openapi.json (OpenAPI 3.1) and in the llms.txt brief.

Base URL & versioning

https://rarext.co/api/v1

Legacy aliases (/api/ai-info, /api/ai-consultant, /api/orders/verify)
respond with Deprecation: true and are removed no earlier than
Sat, 27 Feb 2027 00:00:00 GMT. All responses carry X-API-Version.

Breaking changes ship as a new path version (for example /api/v2/…); each version stays supported at least 6 months after its replacement ships.

Endpoints

curl https://rarext.co/api/v1/health

curl https://rarext.co/api/v1/ai-info

curl -X POST https://rarext.co/api/v1/ai-consultant \
  -H "Content-Type: application/json" \
  -d '{"message":"What does RAREXT do?"}'

curl -X POST https://rarext.co/api/v1/orders/verify \
  -H "Content-Type: application/json" \
  -d '{"orderId":"PAYPAL_ORDER_ID"}'

Errors

Every error is structured JSON — never HTML. Unknown API paths return a JSON 404.

{
  "ok": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "No API endpoint at /api/health.",
    "hint": "See https://rarext.co/developers for the available endpoints."
  }
}

Codes: BAD_REQUEST (400), NOT_FOUND (404), METHOD_NOT_ALLOWED (405), RATE_LIMITED (429), INTERNAL_ERROR (500).

Rate limits

Public endpoints allow 120 requests per minute per IP. Every response carries RFC 9218 RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset headers; exceeding the limit returns 429 with a Retry-After header.

MCP server

The RAREXT MCP server exposes these tools over Streamable HTTP — configurable directly in Claude, ChatGPT, and other MCP clients:

{
  "mcpServers": {
    "rarext": {
      "url": "https://rarext.co/mcp"
    }
  }
}

Tools: rarext_health, rarext_company_info, rarext_ask_consultant. Manifest: /.well-known/mcp/manifest.json.

CLI

npm install -g rarext-cli

rarext status          # liveness probe
rarext info            # company + services JSON
rarext ask "pricing"   # ask the consultant

Authentication

Public endpoints require no API key. Admin, payment, and webhook endpoints are internal and not documented here.