Schedule merges from the API or an AI assistant
Create a key
- Open Settings, API keys, and create one. Choose an access level: read, schedule or admin.
- Copy the secret right away. It is shown once.
- A key acts as the person who made it, in one workspace, and can never do more than that person can in the app.
REST API
- Base address: https://mergescheduler.gentlesoni.online/api/v1. The OpenAPI file is at /api/v1/openapi.json.
- Send times as ISO 8601 with a UTC offset. Add an Idempotency-Key header so retries are safe.
- Limits: 60 requests a minute and 2,000 a day per key.
AI assistant (MCP)
- Server address: https://mergescheduler.gentlesoni.online/mcp, using the same key as a header.
- Works with any MCP client that supports remote servers and custom headers, such as Claude Code or Cursor.
- It can list repositories and pull requests, check readiness, and schedule, move, cancel or revert releases. Every rule of the app still applies.
Full examples are in the API docs.
Background reading: How to let an AI assistant schedule your GitHub merges, safely · Release webhooks: which events to send, how to verify them, how to retry
More guides: Get email, Slack and Discord alerts for every release