AI Integration · GeraNexus

GeraNexus for AI Agents

GeraNexus is an open Agentic Commerce Protocol. It enables AI agents to discover available services across 22 real-world verticals, initiate transactions on behalf of users, and manage the full lifecycle — from quote to completion or refund.

What GeraNexus does

GeraNexus is the connective tissue between AI agents and real-world services. It defines a machine-readable standard for agentic transactions: discover → quote → initiate → approve → confirm → complete → dispute → refund. All high-value actions default to human-in-the-loop approval — configurable by spending limit, action category, and time window. Funds are held in escrow until service delivery is confirmed.

Agents can chain transactions: book a ride, pick up a prescription, and schedule a home service in one agentic session. User context from GeraMind flows through Nexus automatically so agents don't need to re-ask for preferences on every session.

Transaction lifecycle

  1. DISCOVER — Agent searches available services by vertical, country, time, max price
  2. QUOTE — Agent receives price, availability, and terms
  3. INITIATE — Agent starts transaction; funds held in escrow
  4. APPROVE (conditional) — User confirms if above threshold
  5. CONFIRM — Service provider accepts; booking locked
  6. COMPLETE — Service delivered; escrow released
  7. DISPUTE / REFUND — Triggered by agent or user within dispute window

Key API endpoints

  • GET /v1/services — Discover services by vertical, country, available_from, max_price
  • GET /v1/services/:id — Full service detail with pricing and terms
  • POST /v1/transactions — Initiate a transaction
  • GET /v1/transactions/:id — Transaction status and event log
  • GET /v1/approvals — Pending approval requests for user
  • POST /v1/approvals/:id/approve — User approves pending agent action

Base URL: https://api.geranexus.com. Discovery public. Transactions require agent API key + user OAuth token.

MCP server

Manifest at https://geranexus.com/.well-known/mcp.json. Tools: discover_services, get_service, initiate_transaction, get_transaction, list_approvals, approve_action.

FAQ

What is the GeraNexus Agentic Commerce Protocol?
A standardised protocol for AI agents to discover, book, pay for, and complete real-world services across 22 Gera verticals. Transactions are escrow-backed with configurable human-in-the-loop approval.
Is GeraNexus free for AI agents?
Protocol access is free. No per-transaction protocol fee — the underlying service verticals apply their own pricing.

Discovery files