Skip to main content

For Developers · GeraNexus

The open protocol for AI agents that transact in the real world

GeraNexus is an open HTTP protocol specification. Implement it once and your AI agent can discover services, book, pay with escrow, verify delivery, and resolve disputes across any compatible service provider — starting with 35 live Gera services.

Request developer accessRead the spec

Protocol capabilities

  • Service discovery: Any service publishes a /.well-known/gera-nexus.json descriptor listing available actions, parameters, pricing, and availability.
  • Action execution: Your agent sends a signed action payload — the protocol defines the schema for bookings, payments, cancellations, and refunds.
  • Escrow settlement: Pluggable payment layer with authorise, capture, refund semantics — funds held until delivery verified.
  • Delivery verification: Protocol-defined verification step, with optional GeraWitness human review for high-risk actions.
  • Dispute resolution: Standardised process defined in the spec — not left as an application-layer afterthought.
  • Audit trails: Every agent action is signed and logged — essential for EU AI Act compliance.

Frequently asked questions

What does a developer need to implement GeraNexus?

Your AI agent needs to speak HTTP and be able to sign structured action payloads. The GeraNexus spec defines the service discovery endpoint (/.well-known/gera-nexus.json), the action payload schema, the payment authorisation flow, the delivery verification step, and the dispute resolution process. Reference SDKs are available for Node.js and Python.

How is this different from building a Zapier integration?

Zapier requires a human-designed workflow. GeraNexus lets your AI agent discover services autonomously at runtime, negotiate the transaction, hold payment in escrow, verify service delivery, and handle disputes — all within a single protocol session. No workflow template required; the agent drives the interaction.

What services can I test my agent against today?

GeraNexus ships with a reference implementation covering all 36 Gera products: GeraHome (home services), GeraClinic (telemedicine), GeraRide (ride-hailing), GeraEats (food delivery), GeraJobs (job posting), and more. A sandbox environment is available for development testing without live payment charges.

How does the payment and escrow integration work for developers?

The protocol defines a pluggable settlement layer. The reference implementation uses Stripe and GeraCash with authorise, capture, and refund semantics. Your agent calls the authorise endpoint (holds funds in escrow), the service provider fulfils, delivery is verified, and capture completes. If delivery fails, refund is called. You can integrate any PSP that supports the three-step flow.