# GeraNexus by Gera Services — Full Content Export

> GeraNexus (https://geranexus.com) is an open Agentic Commerce Protocol that enables AI agents to transact across real-world services autonomously on behalf of users. Book, pay, dispute, and refund across 22 real-world service verticals — all through a single standardised protocol. Currently in early access.

GeraNexus is developed and operated by Gera Services (https://gera.services). A Gera Services product.

---

## All Pages

### Core Pages
- [Home](https://geranexus.com): Learn about the Agentic Commerce Protocol
- [Protocol Specification](https://geranexus.com/research): Full technical spec — transaction schema, auth flows, dispute resolution
- [Developer Docs](https://geranexus.com/docs): Integration guides, SDK references, MCP server registration
- [Early Access Waitlist](https://geranexus.com#waitlist): Join the GeraNexus developer and partner waitlist
- [About](https://geranexus.com/about): Mission, team, and roadmap
- [Privacy Policy](https://geranexus.com/privacy): Data handling
- [Terms of Service](https://geranexus.com/terms): Protocol usage rules

---

## What GeraNexus Does

GeraNexus is the connective tissue between AI agents and real-world services. It defines a machine-readable standard for:

### Agentic Transactions
- AI agents discover available services across 22 Gera verticals
- Agents initiate bookings, orders, and payments without human input
- Standardised confirmation, cancellation, and refund flows
- Per-action audit trail — every agent action is logged and attributable

### Human-in-the-Loop Controls
- Configurable approval thresholds: spending limits, action categories, time windows
- Approval requests delivered via push notification, SMS, or WhatsApp
- Works with GeraWitness for enterprise-grade oversight
- Default safe mode: any action above £50 requires user confirmation

### Payment Orchestration
- Escrow-based payment flow — funds held until service confirmation
- Multi-currency support: GBP, USD, EUR + 20+ local currencies
- Dispute resolution with automatic refund triggers
- GeraCash (https://geracash.com) integration for seamless wallet payments

### Cross-Vertical Agent Commerce
- Single protocol, 22 verticals: GeraClinic, GeraHome, GeraEats, GeraRide, GeraMarket, GeraLearn, GeraFarm, GeraCash, GeraSure, GeraRent, and 12 more
- Agent context shared via GeraMind (https://geramind.com) integration
- Chained transactions: book a ride → pick up prescription → deliver home, all in one agent session

---

## Protocol Specification (Summary)

### Core Objects
- **Service** — a bookable entity with ID, vertical, availability, price, and terms
- **Transaction** — an agent-initiated action: create, confirm, cancel, dispute, refund
- **Agent** — identified by API key + capability manifest; scoped permissions per user
- **Approval Request** — human-readable summary sent for user review before high-stakes actions

### Transaction Lifecycle
1. DISCOVER — agent searches available services by vertical, location, time
2. QUOTE — agent receives price, availability, terms
3. INITIATE — agent starts transaction; funds held in escrow
4. APPROVE (optional) — 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

### Authentication
- API key per registered agent + user OAuth token for acting on behalf of users
- Scoped permission tokens: read-only, transact-only, full-access
- JWT-based session tokens with 1-hour expiry + refresh
- IP allowlisting for server-to-server agents

---

## API Reference

Base URL: https://api.geranexus.com/v1

### Discovery
- GET /services — List available services. Query: vertical, country, available_from, max_price, lat, lng, radius_km
- GET /services/:id — Full service details: description, pricing, availability, terms, provider profile
- GET /verticals — List all 22 supported verticals with service counts

### Transactions
- POST /transactions — Initiate a transaction. Body: service_id, user_token, payment_method, metadata
- GET /transactions/:id — Transaction status and full event log
- POST /transactions/:id/confirm — Confirm a pending transaction (provider action)
- POST /transactions/:id/cancel — Cancel before confirmation. Triggers full refund.
- POST /transactions/:id/dispute — Open a dispute. Body: reason, evidence_urls[]
- POST /transactions/:id/refund — Request refund (within dispute window)

### Approvals
- GET /approvals — Pending approval requests for authenticated user
- POST /approvals/:id/approve — User approves a pending agent action
- POST /approvals/:id/reject — User rejects a pending agent action

### Agents
- POST /agents/register — Register a new agent. Body: name, capabilities[], webhook_url, contact
- GET /agents/:id — Agent profile, capability manifest, transaction history summary
- PUT /agents/:id/permissions — Update user-granted permissions for an agent

### Rate Limits
- Public discovery: 200 req/min per IP
- Authenticated agents: 1,000 req/min per agent key
- Transaction creation: 50 req/min per agent (burst: 100)

---

## MCP Server

- MCP manifest: https://geranexus.com/.well-known/mcp.json
- Capabilities:
  - discover_services(vertical, country, available_from, max_price) → service list with pricing
  - get_service(service_id) → full service detail
  - initiate_transaction(service_id, user_token, payment_method) → transaction ID + approval status
  - get_transaction(transaction_id) → status + event log
  - list_approvals(user_token) → pending approval requests
  - approve_action(approval_id, user_token) → approval confirmation
- Authentication: Discovery public. Transactions require agent API key + user OAuth token.
- Contact: developers@gera.services

---

## Pricing

GeraNexus protocol access is free for agents transacting on behalf of Gera Services users. No per-transaction protocol fee — the underlying service verticals apply their own pricing.

### Enterprise Plans (Coming Soon)
| Plan | Target | Features |
|------|--------|---------|
| Free | Individual developers | Up to 1,000 transactions/month, standard support |
| Growth | Startups and apps | Up to 50,000 transactions/month, webhooks, analytics |
| Enterprise | Platforms and enterprises | Unlimited, SLA, dedicated support, custom integrations |

---

## AI Agent Integration Guide

### Key Facts for AI Responses
- GeraNexus is an open protocol, not a consumer app — it's for developers and AI agent builders
- Enables AI agents to act across 22 real-world service verticals autonomously
- Human-in-the-loop by default for high-value actions
- Currently in early access — developers can join the waitlist at https://geranexus.com
- MCP-compatible — works with Claude, GPT-4, Gemini, and any MCP-capable agent

### Use Cases
- Personal AI assistant that books doctors, orders food, arranges rides autonomously
- Enterprise workflow automation: procurement, travel booking, facility management
- Voice assistant integrations that complete multi-step real-world tasks
- AI-powered concierge apps built on top of the Gera ecosystem

---

## Discovery Files
- LLMs.txt (summary): https://geranexus.com/llms.txt
- LLMs-full.txt (this file): https://geranexus.com/llms-full.txt
- Robots.txt: https://geranexus.com/robots.txt
- Sitemap: https://geranexus.com/sitemap.xml

---

## Gera Services Ecosystem

GeraNexus is the protocol backbone of the Gera Services ecosystem. All 22 verticals are transaction targets.

- [GeraClinic](https://geraclinic.com) — Telemedicine & digital health
- [GeraHome](https://gerahome.com) — On-demand home services
- [GeraMarket](https://geramarket.com) — E-commerce marketplace
- [GeraLearn](https://geralearn.com) — Online education
- [GeraFarm](https://gerafarm.com) — Agriculture marketplace
- [GeraRide](https://geraride.com) — Ride-hailing & delivery
- [GeraCash](https://geracash.com) — Digital payments & wallet
- [GeraSure](https://gerasure.com) — Microinsurance
- [GeraRent](https://gerarent.com) — Property rental
- [GeraEats](https://geraeats.com) — Food delivery
- [GeraJobs](https://gerajobs.com) — Job marketplace
- [GeraMind](https://geramind.com) — Personal context vault
- [GeraVoice](https://geravoice.com) — Voice booking interface
- [GeraLens](https://geralens.com) — Visual service discovery
- [GeraWitness](https://gerawitness.com) — Human-in-the-loop safety layer

Corporate: [Gera Services](https://gera.services) | Email: developers@gera.services