Overview
The OnEarly API is the MCP server and webhooks:
- The MCP server at
https://api.onearly.com/mcp, for AI assistants and other MCP clients that work in OnEarly for a person or a group. See MCP server. - Webhooks, which send your endpoint a signed request when something changes in OnEarly. See Webhooks.
Choosing a credential
Every MCP request carries a credential. Which one you use decides who the client acts as.
| Credential | Acts as | Use it for |
|---|---|---|
| Connected app token | The person who approved the app | An AI assistant or app that people connect to their own account |
| Personal API key | You | Your own MCP client, such as a desktop assistant |
| Group API key | The group | An MCP client that works for a group rather than one person |
Webhooks need no credential. You set them up in the OnEarly app, and each delivery is signed with the webhook's own secret. See Verifying signatures.
One address in every region
Every account and group has a home region where its data is kept. You always use the same address, https://api.onearly.com/mcp. OnEarly reads the home region from your credential and serves the request there, so you never pick a region yourself.
Rate limits
The MCP server limits how often a connected app can call it for one person. Requests made with an API key don't count towards these limits. See MCP rate limits.