Almonax for AI Agents

Almonax is built for AI agents as a first-class buyer — not an afterthought. Agent rate = human rate (no discrimination).

Three ways an agent can use Almonax

1. MCP (recommended for Claude-family agents)

npm install -g @almonax/mcp
# or via Claude Desktop config:
{
  "mcpServers": {
    "almonax": {
      "command": "npx",
      "args": ["-y", "@almonax/mcp"],
      "env": { "ALMONAX_API_KEY": "ak_live_..." }
    }
  }
}

Exposes almonax_check_balance, almonax_generate_report, almonax_get_report, almonax_run_report_async, and almonax_list_report_types.

2. REST API (any agent)

Bearer auth via Authorization: Bearer ak_live_.... OpenAPI 3.1 spec at /openapi.json.

curl -X POST https://www.almonax.com/api/v1/reports \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"type":"quick_scan","topic":"AI infrastructure series A trends Q1 2026"}'

3. x402 (HTTP 402 + crypto payment — Phase 2)

POST /api/x402/run-report without an API key. First response is HTTP 402 with a USDC quote in the body. Pay on Base/Polygon, re-POST with the payment proof header. Stripe MPP support gated behind verification (see x402.org).

Getting an API key

Sign up at almonax.com (magic-link auth, no password)
Visit /account/api-keys
Click Generate new key — the key is shown ONCE; store securely

Pricing

1 credit = $0.10. Each report type has a fixed credit cost (see almonax_list_report_types or /api/v1/pricing). Buy credits at /account — pure consumption from $20 to $500, +5% bonus at $200+.

Report types

quick_scan — fast read, cheap
standard — balanced
premium — deep multi-source synthesis
role_map — org structure analysis
jd_optimizer — job description optimization
org_snapshot — single-company brief
acquihire_candidates — team-level M&A targets
competitive_talent_brief — recruiting against a competitor
exit_radar — PE portcos in active or imminent sale process (buy-side)
fund_tracker — LP/GP fund closes + active fundraises (LP intel)
risk_pulse — sector layoffs / closures / bankruptcies (downside signals)

Error semantics (REST)

401 — invalid/missing API key
402 — insufficient credits (top up at /account)
422 — validation error
409 — Idempotency-Key reuse with different body
500 — internal

Idempotency

Pass Idempotency-Key: <unique-string> on POST to make retries safe. Cache TTL is 24h. Generate a UUID per logical request.

Discovery

/llms.txt — agent-readable site map (llmstxt.org convention)
/openapi.json — full API spec
/robots.txt — agent allowlist

Contact

Bug reports, feature requests, partnership inquiries: hello@almonax.com.