Guide

Quick start

Five steps from an empty LLM host to a live corporate booking against Anamaya OMS via Anamaya MCP.

1. Register MCP

Point your host at Streamable HTTP. Production hosts get a tenant URL; PoC reference:

{
  "mcpServers": {
    "anamaya": {
      "url": "https://maya.suherman.net/mcp/anamaya/v1",
      "headers": {
        "Authorization": "Bearer <MAYA_ANAMAYA_MCP_API_TOKEN>"
      }
    }
  }
}

Health check: curl -sS https://maya.suherman.net/mcp/anamaya/v1/health

2. OMS login

Call anamaya_login with the traveler’s OMS email and password. Success returns token_cached: true — never a JWT. The MCP gate Bearer token (if set) only opens the endpoint; it does not replace OMS login.

3. Search

Use anamaya_flight_search / hotel tools. Flight depDate is MM-DD-YYYY; passenger counts are strings. Quote only prices in the tool envelope.

4. Confirm

Get an explicit yes in your chat UI before any mutation. Do not auto-book from an exploratory turn.

5. Book

Run the saga with confirm: true on each mutation:

1. anamaya_booking_create
2. anamaya_document_upload → anamaya_booking_attach
3. anamaya_booking_add_flights / anamaya_booking_add_hotels
4. anamaya_booking_approve
5. Poll anamaya_booking_get → anamaya_files_fetch

Next: LLM overview · ChatGPT · Claude · Gemini · Cursor