# Emporium

> Emporium: los instrumentos comunes para agentes, con mandato y límites.
> Emporium: the common instruments for agents, with mandate and limits.

## Español

Esta es la portada de Emporium para un agente: la misma que da la raíz, https://emporium.ultravioletadao.xyz/, a quien la pide con `Accept: text/markdown`. A una persona, la raíz le muestra la portada en HTML, en inglés (en castellano, en https://emporium.ultravioletadao.xyz/es, con la página para quien construye en https://emporium.ultravioletadao.xyz/es/developers): el lema («The building blocks of agentic commerce.»), una frase sobre cómo se arman los bloques, el botón «For developers», que lleva a https://emporium.ultravioletadao.xyz/developers, la página para quien construye, el botón «For agents», que lleva a https://emporium.ultravioletadao.xyz/llms.txt, debajo de los botones la línea «Connect an agent:» con las dos puertas MCP, `https://emporium.ultravioletadao.xyz/mcp` (sign in with your wallet, OAuth 2.1) y `https://emporium.ultravioletadao.xyz/counter/mcp` (no sign-in), y abajo «Privacy» (https://emporium.ultravioletadao.xyz/privacy). Todo lo de abajo responde en este dominio: de las dos puertas MCP, `https://emporium.ultravioletadao.xyz/mcp` pide que la persona entre con su billetera (OAuth 2.1) y el mostrador no; lo demás, sin credencial.

### Qué se puede hacer acá

- Encontrar un negocio o un servicio para lo que pide una persona y pedirle una cotización: `POST https://emporium.ultravioletadao.xyz/mcp`, con `emporium_search_service`, `emporium_business_card`, `emporium_request_quote` y `emporium_read_quote`.
- Ver qué servidores MCP de comercio agéntico tiene el catálogo y cómo conectarse a cada uno: `emporium_surfaces`, `emporium_search_tool` y `emporium_how_to_connect`, en la misma puerta.
- Llamar por una sola puerta las tools de lectura de las plataformas de la casa y sus combos: el mostrador, `POST https://emporium.ultravioletadao.xyz/counter/mcp`.
- Buscar en la guía por HTTP: `GET https://emporium.ultravioletadao.xyz/api/directory?q=<lo que se busca>`.
- Ver la ficha pública de un negocio: `GET https://emporium.ultravioletadao.xyz/n/<slug>`.

### Por dónde seguir

- https://emporium.ultravioletadao.xyz/skill.md: el manual, con los flujos y los errores.
- https://emporium.ultravioletadao.xyz/llms.txt: el mapa, con las superficies del catálogo.
- https://emporium.ultravioletadao.xyz/llms-full.txt: todos los documentos para agentes, en uno.
- https://emporium.ultravioletadao.xyz/auth.md: cómo se entra y qué credenciales no hacen falta.
- https://emporium.ultravioletadao.xyz/openapi.json: las rutas HTTP.
- https://emporium.ultravioletadao.xyz/.well-known/mcp/server-card.json: la tarjeta del servidor MCP.
- https://emporium.ultravioletadao.xyz/.well-known/agent-card.json: la tarjeta A2A: habla MCP, no A2A.

### Lo que no hace

- Emporium no cobra y no mueve dinero: enlaza el medio de pago que declaró cada negocio, y paga la persona.
- Emporium no custodia llaves de nadie. De tokens guarda uno: el vínculo con la billetera de la persona que entra a su web, cifrado (`/auth.md`).

## English

This is the front page of Emporium for an agent: the same one the root, https://emporium.ultravioletadao.xyz/, gives to whoever asks for it with `Accept: text/markdown`. To a person, the root shows the front page in HTML, in English (in Spanish, at https://emporium.ultravioletadao.xyz/es, with the page for whoever builds at https://emporium.ultravioletadao.xyz/es/developers): the motto ("The building blocks of agentic commerce."), a sentence on how the blocks fit together, the "For developers" button, which goes to https://emporium.ultravioletadao.xyz/developers, the page for whoever builds, the "For agents" button, which goes to https://emporium.ultravioletadao.xyz/llms.txt, below the buttons the line "Connect an agent:" with the two MCP doors, `https://emporium.ultravioletadao.xyz/mcp` (sign in with your wallet, OAuth 2.1) and `https://emporium.ultravioletadao.xyz/counter/mcp` (no sign-in), and at the bottom "Privacy" (https://emporium.ultravioletadao.xyz/privacy). Everything below answers on this domain: of the two MCP doors, `https://emporium.ultravioletadao.xyz/mcp` asks the person to sign in with their wallet (OAuth 2.1) and the counter does not; the rest takes no credential.

### What you can do here

- Find a business or a service for what a person asks for and request a quote: `POST https://emporium.ultravioletadao.xyz/mcp`, with `emporium_search_service`, `emporium_business_card`, `emporium_request_quote` and `emporium_read_quote`.
- See which MCP servers for agentic commerce the catalog has and how to connect to each one: `emporium_surfaces`, `emporium_search_tool` and `emporium_how_to_connect`, at the same door.
- Call the read-only tools of the house platforms and their combos through a single door: the counter, `POST https://emporium.ultravioletadao.xyz/counter/mcp`.
- Search the guide over HTTP: `GET https://emporium.ultravioletadao.xyz/api/directory?q=<what you look for>`.
- See a business's public profile: `GET https://emporium.ultravioletadao.xyz/n/<slug>`.

### Where to go next

- https://emporium.ultravioletadao.xyz/skill.md: the manual, with the flows and the errors.
- https://emporium.ultravioletadao.xyz/llms.txt: the map, with the catalog surfaces.
- https://emporium.ultravioletadao.xyz/llms-full.txt: every document for agents, in one.
- https://emporium.ultravioletadao.xyz/auth.md: how to sign in and which credentials are not needed.
- https://emporium.ultravioletadao.xyz/openapi.json: the HTTP routes.
- https://emporium.ultravioletadao.xyz/.well-known/mcp/server-card.json: the MCP server card.
- https://emporium.ultravioletadao.xyz/.well-known/agent-card.json: the A2A card: it speaks MCP, not A2A.

### What it does not do

- Emporium does not charge and does not move money: it links the payment method each business declared, and the person pays.
- Emporium does not hold anyone's keys. Of tokens it holds one: the wallet link of a person who signs in on its website, encrypted (`/auth.md`).
