# Spiral

- [Introduction](https://magica-c99dce00.mintlify.dev/docs/index.md): One API for every AI tool your agent needs.
- [Quickstart](https://magica-c99dce00.mintlify.dev/docs/quickstart.md): Create a key, then make your first run.
- [Authentication](https://magica-c99dce00.mintlify.dev/docs/authentication.md): Every request carries an API key as a bearer token.
- [Runs](https://magica-c99dce00.mintlify.dev/docs/concepts/runs.md): Start a run, follow it, and read its result.
- [Pricing and billing](https://magica-c99dce00.mintlify.dev/docs/concepts/pricing.md): How to work out a run's price, and how it is held and charged.
- [Files](https://magica-c99dce00.mintlify.dev/docs/concepts/files.md): Upload an input file once, then use its id in any run.
- [Webhooks](https://magica-c99dce00.mintlify.dev/docs/concepts/webhooks.md): Get a run's result pushed to your server, signed.
- [Idempotency](https://magica-c99dce00.mintlify.dev/docs/concepts/idempotency.md): Retry a run safely without starting it twice or paying twice.
- [App attribution](https://magica-c99dce00.mintlify.dev/docs/concepts/app-attribution.md): Name the app behind each run and get listed in the public Apps ranking.
- [Rate limits](https://magica-c99dce00.mintlify.dev/docs/concepts/rate-limits.md): Per-key limits, the headers that report them, and what to do when you hit one.
- [Errors and retries](https://magica-c99dce00.mintlify.dev/docs/concepts/errors.md): How errors look, and which ones to retry.
- [Introduction](https://magica-c99dce00.mintlify.dev/docs/api-reference/introduction.md): The Spiral REST API.
- [Errors](https://magica-c99dce00.mintlify.dev/docs/api-reference/errors.md): Every error code, what it means and whether to retry.
- [List providers](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/providers.md)
- [Search the catalog](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/tools.md)
- [Inspect a model](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/inspect.md)
- [Create a run](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/post-runs.md)
- [Get a run](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/get-run.md)
- [List runs](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/list-runs.md)
- [Upload a file](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/post-files.md)
- [Get a file](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/get-file.md)
- [Get the balance](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/balance.md)
- [Get the current key](https://magica-c99dce00.mintlify.dev/docs/api-reference/endpoint/me.md)
- [MCP server](https://magica-c99dce00.mintlify.dev/docs/mcp-server.md): Give any agent every tool through the hosted MCP server.
- [MCP tools](https://magica-c99dce00.mintlify.dev/docs/mcp-server/tools.md): Every tool the hosted MCP server offers, with its scope and arguments.
- [Skill](https://magica-c99dce00.mintlify.dev/docs/mcp-server/skill.md): Set up any agent with one line.
- [Claude Code](https://magica-c99dce00.mintlify.dev/docs/quickstarts/claude-code.md): Add Spiral to Claude Code with one command.
- [Codex](https://magica-c99dce00.mintlify.dev/docs/quickstarts/codex.md): Add Spiral to Codex.
- [Cursor](https://magica-c99dce00.mintlify.dev/docs/quickstarts/cursor.md): Add Spiral to Cursor.
- [VS Code](https://magica-c99dce00.mintlify.dev/docs/quickstarts/vscode.md): Add Spiral to VS Code.
- [Claude Desktop](https://magica-c99dce00.mintlify.dev/docs/quickstarts/claude-desktop.md): Add Spiral to Claude Desktop.

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.