ezerve

← All help articles

For business owners

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.

Where this is in early access

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