ezerve

← All help articles

How do I use the ezerve API and MCP server?

ezerve is API-first: the public API and the MCP server are part of the platform, reading the same live data your booking site does — never a stale export.

What the API covers

Version 1 is read-only and mirrors the spine: assets, offerings, availability, reservations, and customers. Responses use a stable envelope — data, pagination, links — with cursor-based pagination for anything list-shaped. An OpenAPI description is published, so generated clients work out of the box.

Tokens

API access uses bearer tokens with the ezk_ prefix. The rules are strict because they're cheap now and priceless later:

  • A token is shown once, at creation. Store it then; ezerve keeps only a hash, so it can never be shown again.
  • Tokens carry scopes — grant a reporting integration read access to reservations without exposing customers.
  • Tokens are revocable instantly, and every mint and revocation lands in your audit trail.

Rate limits

Requests are limited per token (60/min at v1) with additional per-IP limits. Hitting a limit returns 429 with a Retry-After header — back off for that long and continue. If your integration legitimately needs more, talk to us.

Field stability

Integrations shouldn't break because we shipped a feature. Fields are added, never repurposed; breaking changes mean a new API version, and v1 keeps working.

The MCP server

The MCP server at api.ezerve.com/mcp exposes the same reads as the REST API — same ezk_ tokens, same permissions — as tools that AI agents can call directly. In practice: an assistant can search your live availability and read reservation details, which makes your business agent-bookable in the discovery sense from day one. Tools that write (creating or holding a reservation) exist behind an explicit opt-in with an approvals flow — nothing books against your calendar via MCP unless you've turned that on.

Availability

The API and MCP server ship to businesses alongside the first public surfaces. Token management appears in your admin settings when it's live for your account.