# eesel AI Developer Resources

These resources describe the public utility and preview endpoints used by the eesel AI website. They are not the private eesel AI dashboard API.

## API reference

The machine-readable API description is available at [openapi.json](https://www.eesel.ai/openapi.json). It lists request bodies, response bodies, errors, version headers, and rate-limit headers for each public endpoint.

## Authentication

The endpoints in the published OpenAPI file do not require authentication. Do not send eesel AI dashboard credentials to them. Private dashboard and administrative endpoints are not part of this public API.

## Versioning and deprecation

Send the optional `API-Version` request header with the version declared in the OpenAPI file. Requests without it use the current version. A breaking change receives a new version. Deprecations are announced in the developer resources and returned with an HTTP `Deprecation` header. A planned removal also includes a `Sunset` header at least 90 days before removal.

## Rate limits

Public API responses include the RFC `RateLimit` and `RateLimit-Policy` fields. Compatibility fields `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` are also returned. A response with status 429 includes `Retry-After`. Clients should wait for that interval before retrying.

## Errors

Errors use JSON with four fields: `error`, `code`, `message`, and `hint`. Use `code` for program logic, show `message` to a person, and follow `hint` when retrying.

## CLI and workspace MCP

eesel AI ships an official command-line tool: `npx @eesel/cli` (npm, nothing to install) or `curl -fsSL https://dashboard.eesel.ai/eesel-cli/install | sh`. `eesel login` signs in with one browser hop. From there `eesel init chat-bubble --site <url>` sets up a website chat bubble and prints the embed snippet, `eesel integrations connect <platform>` connects a helpdesk or Slack, and `eesel chat`, `eesel files`, `eesel instructions`, `eesel automations`, and `eesel billing` cover the rest. Commands print JSON, so a coding agent can run the whole setup. Full reference: [The eesel CLI](https://docs.eesel.ai/apis-and-developer-resources/cli).

Every eesel AI workspace is also an authenticated MCP server. Mint a token with `eesel mcp token` and register the workspace in Claude Code, Cursor, or any MCP client, as described in [Claude Code & MCP clients](https://docs.eesel.ai/apis-and-developer-resources/claude-code-and-mcp-clients). This authenticated workspace server is separate from the read-only public MCP server below.

## Webhooks and MCP

eesel AI provides a read-only public MCP server at [https://www.eesel.ai/mcp](https://www.eesel.ai/mcp). It uses Streamable HTTP and exposes public product information, developer resources, and the OpenAPI URL as tools. Its manifest is available at [mcp.json](https://www.eesel.ai/mcp.json). eesel AI does not currently publish a general-purpose webhook API.