# Sumbloom Puzzles API by CyberMax

> Original number puzzles for people, apps and AI agents: Target (reach a number with + - x /), Cage Grids (4x4 easy, 5x5 medium, 6x6 hard, exactly one solution each) and Brick Pyramids. JSON or printable SVG, with solutions. Free tier: 50 puzzles a day, 30 calls/min per IP, no key; paid API keys for more.

> Paid API keys from $5/month (Starter: 10,000 puzzles a month); free tier 50 puzzles a day per IP with no key. Buy: https://sumbloom.cybermaxtools.com/buy/starter?s=lead · all plans: https://sumbloom.cybermaxtools.com/docs#pricing

- GET https://sumbloom.cybermaxtools.com/v1/puzzle?type=cage&level=medium&seed=abc  -> puzzle JSON + solution
- GET https://sumbloom.cybermaxtools.com/v1/puzzle?type=target&daily=true           -> today's puzzle (same for everyone)
- GET https://sumbloom.cybermaxtools.com/v1/puzzle.svg?type=pyramid&level=hard       -> printable SVG (add &solution=true for the answer)
- MCP (streamable HTTP): https://sumbloom.cybermaxtools.com/mcp  tool: get_number_puzzle
- OpenAPI: https://sumbloom.cybermaxtools.com/openapi.json

Printable book with 120 puzzles and answers (US Letter + A4, classroom licence): https://cybermax-tools-cybermax.static.hf.space/sumbloom-book/index.html
All CyberMax tools: https://cybermax-tools-cybermax.static.hf.space/
CyberMax Store (all paid products): https://cybermaxtools.com/store/

## Pricing
- Free: 50 puzzles a day per IP, 30/min, no key.
- Starter: $5/month, 10,000 puzzles a month, 60/min. Buy: https://sumbloom.cybermaxtools.com/buy/starter?s=llms
- Pro: $15/month, 100,000 puzzles a month, 120/min. Buy: https://sumbloom.cybermaxtools.com/buy/pro?s=llms
- Starter yearly: $50/year, 10,000 puzzles a month, 60/min. Buy: https://sumbloom.cybermaxtools.com/buy/starter-yearly?s=llms
- Pro yearly: $150/year, 100,000 puzzles a month, 120/min. Buy: https://sumbloom.cybermaxtools.com/buy/pro-yearly?s=llms
- Use the key as `x-api-key: KEY` or `Authorization: Bearer KEY` (MCP too). Usage: https://sumbloom.cybermaxtools.com/key. Machine-readable: https://sumbloom.cybermaxtools.com/pricing.json

## Pay per call (x402, USDC on Base): for AI agents, no key, no account
- $0.002 per call, paid in USDC on Base (x402 "exact" scheme, v1 and v2).
- https://sumbloom.cybermaxtools.com/x402/v1/puzzle: same as /v1/puzzle, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- https://sumbloom.cybermaxtools.com/x402/v1/puzzle.svg: same as /v1/puzzle.svg, always pay-per-call (an unpaid call returns HTTP 402 with the payment requirements).
- Plain endpoints keep the free tier and API keys; with no key, they also answer 402 (instead of 429) once the free daily quota is used.
- Send the signed payment as X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2); the receipt comes back in X-PAYMENT-RESPONSE / PAYMENT-RESPONSE. Failed calls are not charged.