---
title: "Developers — Alchemyst Press API"
description: "Public read API, MCP server, OpenAPI spec, and quickstart for Alchemyst Press."
canonical: "https://press.getalchemystai.com/developers"
last_updated: "2026-11-17"
---

# Developers — Alchemyst Press API

> Public read API for the book index and editorial answers. No keys required.

## Quickstart

- List books and chapters: `GET https://press.getalchemystai.com/api/v1/books?limit=20` (follow `next_cursor`)
- Ask: `POST https://press.getalchemystai.com/api/v1/answer` with `{ "query": "..." }` (`Prefer: respond-async` for a 202 job at `/api/v1/jobs/{id}`)
- Tools: `POST https://press.getalchemystai.com/api/v1/tools`, bulk: `POST https://press.getalchemystai.com/api/v1/tools/batch`
- MCP server: `https://press.getalchemystai.com/mcp` (Streamable HTTP, no auth) — tools search_books, list_books, get_chapter, ask_press
- NLWeb: `POST https://press.getalchemystai.com/ask` with `{ "query": { "text": "..." } }`
- Spec: [OpenAPI](https://press.getalchemystai.com/openapi.json) · [API catalog](https://press.getalchemystai.com/.well-known/api-catalog) · [Section guide](https://press.getalchemystai.com/developers/llms.txt)
- Portal: [Developers](https://press.getalchemystai.com/developers)

## Conventions

- Authentication: none ([auth.md](https://press.getalchemystai.com/auth.md)).
- Versioning: URL path `/api/v1`; responses carry `API-Version: 1`. Breaking changes ship as `/api/v2`, and v1 then gets `Deprecation`/`Sunset` headers for 90+ days.
- Rate limits: 60 requests/minute per client; `RateLimit-Policy`, `RateLimit`, and `Retry-After` on 429.
- Idempotency: send `Idempotency-Key` on POST to retry safely.
- Sandbox: every endpoint is read-only and side-effect free, so production doubles as the sandbox.
- Errors are JSON with `error`, `message`, `hint`.

---

- [About](https://press.getalchemystai.com/about)
- [Books](https://press.getalchemystai.com/books)
- [Get in touch](https://press.getalchemystai.com/get-in-touch)
- [Contact](https://press.getalchemystai.com/contact)
- [Privacy](https://press.getalchemystai.com/privacy)
- [Developers](https://press.getalchemystai.com/developers)
- [OpenAPI](https://press.getalchemystai.com/openapi.json)
- [Sitemap](https://press.getalchemystai.com/sitemap.xml)
- [Agent guide](https://press.getalchemystai.com/llms.txt)
- [Docs](https://www.getalchemystai.com/docs)
