Skip to main content

GeraNexus AI utility · Agentic commerce

How AI agents book real-world services

AI agents can now book a plumber, hire a freelancer, order food, or schedule a health consultation — all without human intervention. GeraNexus is the commerce protocol that makes this possible: structured APIs, payment escrow, delivery verification, and dispute resolution in one open spec. This page explains how the full booking lifecycle works.

The 5-step booking lifecycle

  1. Service discovery: The agent calls discover_services(type, location, urgency). GeraNexus returns a ranked list of available providers with pricing, availability, and Passport badge status.
  2. Booking confirmation: The agent calls book_service(providerId, jobScope, slot). A booking record is created and a warranty receipt is pre-generated.
  3. Payment authorisation: The agent authorises payment with authorise_payment(bookingId, amount). Funds are held in escrow — not captured yet.
  4. Delivery verification: On job completion, GeraWitness captures a signed event. The agent calls verify_completion(bookingId).
  5. Capture or dispute: If verified, capture_payment() releases funds to the provider. If disputed, the escrow refunds automatically.

FAQ

How does an AI agent book a real-world service?

An AI agent books a service by calling a structured API endpoint that implements the GeraNexus commerce protocol. The agent calls discover_services(), selects a provider, calls book_service() with job scope and time slot, authorises payment with escrow, and receives a booking confirmation and warranty receipt. The human reviews and approves before the payment captures.

What is the GeraNexus protocol?

GeraNexus is an open commerce protocol for AI agents to conduct real-world service transactions. It defines the full lifecycle: service discovery, quote comparison, booking, payment authorisation with escrow, delivery verification via GeraWitness, and dispute resolution. Any service platform can implement the protocol and become accessible to any GeraNexus-compatible AI agent.

Is payment safe when an AI agent books on my behalf?

Yes. GeraNexus uses authorise-then-capture semantics. The AI agent authorises the payment, which holds the funds in escrow. The capture only occurs after GeraWitness confirms service delivery or you manually approve. If delivery fails, the escrow refunds automatically.

Which AI agents support GeraNexus?

Any HTTP-capable agent can call GeraNexus APIs. GeraNexus also exposes MCP (Model Context Protocol) servers compatible with Claude and other MCP-enabled agents. ChatGPT function-calling agents, LangChain agents, and custom agents can all interact with GeraNexus via REST.

The commerce layer for AI agents

Open protocol. MCP-compatible. Escrow, verification, and dispute resolution built in.

Join the developer waitlist