# JustPush

> Push notifications, dead simple. JustPush sends instant push notifications to
> your own phone from any script, server or service — one HTTP POST, no backend
> to deploy, no APNs/FCM certificates to manage. Free mobile apps for iOS and
> Android; a 30-day free trial, then $19.99/year or $39.99 once.

The whole API is a single call. Send a message by POSTing JSON to
`https://api.justpush.io/messages`; the API token goes in the `user` field of
the body (user tokens start with `m_`), not in a header.

```
curl -X POST https://api.justpush.io/messages \
  -H "Content-Type: application/json" \
  -d '{
    "user": "<< API TOKEN >>",
    "title": "Deploy succeeded",
    "message": "v2.4.1 shipped to production in 14s",
    "topic": "deploys",
    "sound": "COSMIC"
  }'
```

A message can carry a title and body, a topic, a priority, one of 22 built-in
sounds, up to 10 images with captions, up to 10 buttons (or 4 button groups),
an acknowledgement-with-retry loop, and an expiry TTL. Topics are channels;
they are created on the fly if they don't exist. There is also an
email-to-push gateway: forward mail to your personal `e_…@jpml.io` address and
control it with `topic=`, `sound=`, `priority=` and `requires_acknowledgement=1`
lines in the body.

## Docs

- [Documentation](https://docs.justpush.io/): full product and API documentation. Append `.md` to any page URL for Markdown.
- [Documentation index for LLMs](https://docs.justpush.io/introduction/llms.txt): the complete doc tree in llms.txt format.
- [OpenAPI spec](https://docs.justpush.io/introduction/dev-tools/openapi.md): machine-readable description of the REST API.
- [Postman collection](https://docs.justpush.io/introduction/dev-tools/postman.md): importable request collection.

## For agents

- [How to authenticate](https://www.justpush.io/auth.md): getting an API token, and the OAuth flow used by the MCP server.
- [API catalog](https://www.justpush.io/.well-known/api-catalog): RFC 9727 linkset for the REST API.
- [MCP server card](https://www.justpush.io/.well-known/mcp/server-card.json): the hosted MCP server at `https://api.justpush.io/mcp/justpush`, which exposes `send-message`, `list-topics` and `create-topic`.
- [MCP setup guide](https://docs.justpush.io/introduction/dev-tools/mcp-server.md): connecting the MCP server to Claude. Auth is a one-time email code — no API key needed.
- [Agent skills](https://www.justpush.io/.well-known/agent-skills/index.json): installable skills for sending JustPush notifications.

## SDKs

- [PHP](https://docs.justpush.io/): `composer require justpush/sdk`
- [JavaScript / TypeScript](https://docs.justpush.io/): `npm i @justpush/sdk`
- [Go](https://docs.justpush.io/): `go get github.com/justpush/go`
- [Ruby](https://docs.justpush.io/): `gem install justpush`
- [Rust](https://docs.justpush.io/): `cargo add justpush`
- [Python](https://docs.justpush.io/): community SDK, in beta

## Optional

- [Site as Markdown](https://www.justpush.io/index.md): this marketing page in Markdown.
- [Get the app for iOS](https://apps.apple.com/us/app/justpush-io/id6738397112)
- [Get the app for Android](https://play.google.com/store/apps/details?id=com.justpush)
- [GitHub](https://github.com/JustPush-io/): official SDKs and examples.
- [Terms](https://www.justpush.io/#/terms) and [Privacy](https://www.justpush.io/#/privacy)