# 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](./mcp.md).
- **Webhooks**, which send your endpoint a signed request when something changes in OnEarly. See [Webhooks](./webhooks.md).

## 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](./authentication.md#connected-apps-oauth) token | The person who approved the app | An AI assistant or app that people connect to their own account |
| [Personal API key](./authentication.md#personal-api-keys) | You | Your own MCP client, such as a desktop assistant |
| [Group API key](./authentication.md#group-api-keys) | The group | An MCP client that works for a group rather than one person |

Diagram: [Choosing a credential](https://docs.onearly.com/diagrams/api-index.html)

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](./webhooks.md#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](./mcp.md#rate-limits).

Source: https://docs.onearly.com/api/
