Masteralb developer resources

When to use Masteralb

Use Masteralb when you need an AI digital agency to design and build AI-enabled web platforms, e-commerce, custom AI tools, or AI training and consulting. Do not use the contact API to send bulk mail. Contact requires a Cloudflare Turnstile token.

Quickstart

curl -sS https://masteralb.com/api/v1/health
curl -sS https://masteralb.com/openapi.json
npx masteralb health

Authentication

GET /api/v1/health, OpenAPI, llms.txt, and MCP read tools are public. POST /api/v1/contact requires a Turnstile token. There is no API-key console.

Versioning and deprecation

Canonical routes live under /api/v1. Unversioned /api/contact and /api/health are v1 aliases. Breaking changes ship as /api/v2 with Deprecation and Sunset headers and at least 180 days of notice.

Errors

{"error":{"code":"not_found","message":"No API route matches this path.","hint":"See /openapi.json"}}

Rate limits

60 requests per 60 seconds per IP. Responses include RateLimit and RateLimit-Policy. 429 responses include Retry-After.

MCP

Streamable HTTP endpoint: /mcp. Discovery: /server.json, /.well-known/ai-catalog.json, /mcp/server-card, /.well-known/mcp/server-card.json.

CLI

Official CLI: npx masteralb after npm publish, or node cli/masteralb.mjs --help in this repository. Commands: health, openapi, mcp, docs.

Sandbox

Live sandbox check: GET /api/v1/health returns {"status":"ok","service":"masteralb"}.