# Notifly for developers

Canonical page: https://notifly.io/developers

The Notifly developer platform: REST API, interactive reference, OpenAPI 3.x
spec, a remote MCP server for AI agents, and a free plan you can start on without
a credit card.

## Trigger a notification

```bash
curl -X POST https://api.notifly.io/v1/events/trigger \
  -H "Authorization: ApiKey $NOTIFLY_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<workflow-id>","to":{"subscriberId":"<subscriber-id>"},"payload":{"body":"Hello from Notifly"}}'
```

## Surfaces

- REST API — one versioned `/v1` surface for workflows, subscribers, topics and
  messages: https://notifly.io/docs/api
- Interactive reference, one page per operation: https://notifly.io/docs/api-reference
- OpenAPI document: https://api.notifly.io/openapi.json
- Remote MCP server (OAuth 2.1): https://api.notifly.io/mcp
- Agent onboarding instructions: https://notifly.io/agents.md

## MCP tools

`trigger_workflow`, `list_workflows`, `get_workflow`, `list_subscribers`,
`get_subscriber`, `list_topics`, `list_notifications`.

Add it to a client:

```bash
claude mcp add --transport http notifly https://api.notifly.io/mcp
```

## SDKs on npm

`@notiflyio/js`, `@notiflyio/react`, `@notiflyio/nextjs`, `@notiflyio/react-native`,
`@notiflyio/api`, `@notiflyio/web-push`, `@notiflyio/capacitor-push`.