# Egonex

> Egonex is a marketplace where people buy and sell through their personal agents. Individual people sell items (new and used), lessons, services in person or online, digital goods, rentals and custom work, and each seller's own AI assistant, Ego, can answer buyers. AI agents are welcome: any agent can search every listing, ask about one and start an order for its person. Nothing is ordered or paid until that person approves the payment: on Egonex, or in Stripe Link when their agent pays with a Stripe Shared Payment Token.

No account or API key is needed to search, ask or start an order. Prices are fixed per listing, in USD. Listings change often, so search again instead of relying on old results.

## For AI agents

- [MCP server](https://api.egonex.ai/api/v1/mcp): Streamable HTTP, stateless, POST only. Tools: search_offers, ask_seller, request_order, check_request, pay_order (listed only while direct payment is on; always check tools/list).
- [Agent API reference (OpenAPI 3.1)](https://shop.egonex.ai/openapi.json): every REST parameter and response field, with the values it takes.
- [Search listings (REST)](https://api.egonex.ai/api/v1/agent/offers): GET with q, category, city, min_price, max_price, delivery (onsite, remote or hybrid), condition (physical items: the lowest condition accepted, new > like_new > good > fair > for_parts; listings that don't state one are included), store, limit and offset. Physical items come back with their condition and ships = true when the seller posts them (the buyer gives an address at Egonex checkout).
- Read one store (REST): GET https://api.egonex.ai/api/v1/agent/stores/{store}
- Ask about a listing (REST): POST https://api.egonex.ai/api/v1/agent/offers/{offer_id}/questions with {"question": "..."}
- Start an order or send a message for your person (REST): POST https://api.egonex.ai/api/v1/agent/requests with {"offer_id": "...", "kind": "order" or "message", "message": "...", "agent_name": "..."}. Returns a confirm_url for your person.
- Check a request (REST): GET https://api.egonex.ai/api/v1/agent/requests/{id}. One status from the confirm link to the end of the order: pending, declined, expired (requests expire after 7 days) or listing_unavailable (the listing isn't for sale anymore, so it can't be confirmed); then message_sent, awaiting_order (the chat is open but nothing is ordered yet) and the order's stage: payment_in_progress, payment_failed, waiting_for_seller, ready_to_pay, paid, delivered, refund_requested, completed, refund_pending, refunded or closed_unpaid (close_reason says why).
- Pay directly (REST): when the order response includes payment, POST https://api.egonex.ai/api/v1/agent/requests/{id}/pay with {"shared_payment_token": "spt_...", "buyer_email": "...", "quantity": 1, "delivery_days": 3, "accept_terms": true}. Uses a Stripe Shared Payment Token your person approved; no confirm page.
- [For agents](https://egonex.ai/agents): the same, for people building agents.

## Browse

- [Sellers directory](https://shop.egonex.ai/sellers): every store on Egonex, searchable by words, category and city.
- Seller pages: https://shop.egonex.ai/@{store}. Every listing has Ask and Order, and a buyer only needs an email address.

## How an order works

1. Search listings (search_offers).
2. If your person needs a detail, ask about the listing (ask_seller). When the seller's Ego is answering, the answer comes back right away, written only from the seller's public listing. Ego does not agree prices with agents.
3. Start the order (request_order) and give the confirm_url to your person.
4. Your person opens it, checks the listing and the price, enters an email address and pays on Egonex. Nothing is ordered or charged until then, and no Egonex account is needed.
5. Follow it with check_request: the status keeps following the order to the end (paid, delivered, completed; or refunded / closed_unpaid).

Or, instead of steps 3–5: if the order response includes payment and your person approved a Stripe Shared Payment Token (for example in Stripe Link), pay with pay_order after they agreed to the purchase and to Egonex's terms. Egonex creates the order on their email and charges the token; the seller then has 12 hours to accept, otherwise your person is refunded minus the payment processing fee.