# OKMQ

> Simple, reliable message queues and streams over REST and MCP. OKMQ gives AI coding agents persistent, durable task coordination: create queues, send and receive messages, acknowledge or re-deliver, and track every message's lifecycle with Postgres-backed durability and configurable retry strategies.

## Docs

- [Getting Started](https://okmq.net/docs): Authentication, create a queue, send, receive, ack — the core loop in minutes.
- [Queues Guide](https://okmq.net/docs/queues): Retry strategies (exponential, linear, fixed, none), TTL, tags, scheduled delivery, lock duration, peek and status filters.
- [Streams Guide](https://okmq.net/docs/streams): Append-only event logs with committed offsets and exactly-once consumption.
- [API Reference](https://okmq.net/api): Full OpenAPI catalog of REST endpoints for queues, streams, messages, and topics.
- [curl Cookbook](https://okmq.net/docs/cookbook): The entire API as copy-paste curl commands — queues, messages, ack/nack, scheduled delivery, topics, streams, offsets. No SDK or client library needed.
- [MCP Server](https://okmq.net/docs/mcp): Connect Claude Code, opencode, Cursor, VS Code, and Codex to OKMQ over the Model Context Protocol; setup snippets per client.
- [Agentic Patterns](https://okmq.net/docs/agents): Agent orchestration over tagged queues — work-stealing pools, escalation ladders, reply chains, priority patterns.

## MCP

- [MCP endpoint](https://api.okmq.net/mcp): Streamable-HTTP endpoint; authenticate with the same Bearer API key as the REST API.
- [okmq tools](https://okmq.net/docs/mcp): The eight okmq_* tools (status, create_queue, send, receive, peek, ack, nack, delete_queue) with schemas and workflow guidance.

## Reference

- [Setup snippets](https://okmq.net/docs/mcp): `claude mcp add --transport http okmq https://api.okmq.net/mcp --header "Authorization: Bearer $OKMQ_API_KEY"` plus client config for opencode, Cursor, VS Code, and Codex.
- [Pricing](https://okmq.net/pricing.md): Machine-readable plan list — Free ($0: 100 MB, 100k messages), Starter ($5: 1 GB, unlimited messages), Pro ($10: 2 GB, 100 channels). Flat monthly pricing, no metered billing.

## Optional

- [Terms and Conditions](https://okmq.net/terms): Acceptable use, data privacy, and service agreement.
- [Contact](https://okmq.net/contact): Reach the OKMQ team for feature questions or support.