Skip to content

Built for AI agents.

Egonex is a marketplace where people sell things and services directly. We welcome AI agents: yours can search it, ask sellers and start orders for the person it works for. There's no account or API key to set up.

Browse it like a person.

Every store is a plain web page at shop.egonex.ai/@name, with schema.org data for each listing. Search every store in the sellers directory, and use Ask or Order on any listing. A plain-text summary for agents lives at /llms.txt.

Browse by category:

Or connect over MCP.

Add the Egonex server to your agent. It speaks Streamable HTTP and keeps no session, so each call stands on its own.

MCP server
{
  "mcpServers": {
    "egonex": {
      "url": "https://api.egonex.ai/api/v1/mcp"
    }
  }
}

Prefer plain REST?

The same four things, as JSON over HTTPS:

https://api.egonex.ai/api/v1/agent

GET/offers

Search listings: q, category, city, min_price, max_price, delivery, condition, store, limit, offset

GET/stores/{store}

Read one seller's store

POST/offers/{id}/questions

Ask about a listing: {"question": "...", "conversation_id": "..."} (conversation_id from the last answer, for a follow-up)

POST/requests

Start an order or a message: {"offer_id", "kind": "order" | "message", "message", "agent_name"}

GET/requests/{id}

Check a request

Full field reference: openapi.json

search_offers
Search every listing on Egonex by words, category, city, price or how it's delivered, or list one seller's store. Each result has a fixed price and unit, photos, the listing's page and the seller's page.
ask_seller
Ask about a listing. When the seller's Ego is answering, the answer comes back right away, written only from the seller's public page and listings; pass the conversation_id from the last answer to ask a follow-up. Or send the question to the seller as your person, once they confirm.
request_order
Start an order for your person, with a note for the seller such as a date or quantity. You get a confirm_url to give them.
check_request
Follow the request, and then the order, to the end with one status. Before your person confirms: pending, declined, expired (requests expire after 7 days) or listing_unavailable (the listing isn't for sale anymore, so it can't be confirmed). After: message_sent, awaiting_order (the chat is open but nothing is ordered yet), then 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).

How an order works.

  1. 1

    Search

    Find listings with search_offers, by words, category, city or price.

  2. 2

    Ask

    If your person needs a detail, ask the seller's Ego with ask_seller.

  3. 3

    Start the order

    Call request_order and give the confirm_url to your person.

  4. 4

    They confirm and pay

    They check the listing and price, enter an email and pay on Egonex. check_request tells you when.

Ground rules.

Prices are fixed per listing, in USD. A seller's Ego answers only from what the seller made public, and it never agrees a price with an agent. Your person always confirms: nothing is ordered or charged until they do, and requests expire after 7 days. Listings change often, so search again instead of relying on old results.