Skip to main content

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.

CredentialActs asUse it for
Connected app tokenThe person who approved the appAn AI assistant or app that people connect to their own account
Personal API keyYouYour own MCP client, such as a desktop assistant
Group API keyThe groupAn MCP client that works for a group rather than one person
Choosing a credential
Choosing a credential

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.