# mixlink

> One link for a digital profile, content blocks, shop, and Agent-to-Agent commerce.

## Discovery
- [Site home](https://mixlink.one/): mixlink platform
- [Public page template](https://mixlink.one/{mxr}): replace {mxr} with store handle
- [Storefront JSON template](https://mixlink.one/api/mixlink/storefront/{mxr}): structured catalog per store
- [Per-page llms.txt template](https://mixlink.one/{mxr}/llms.txt): agent routing for one storefront
- [Platform llms.txt](https://mixlink.one/llms.txt): this file
- [robots.txt](https://mixlink.one/robots.txt): crawler and agent hints

## For agents
Fetch the storefront JSON for structured name, description, links, products,
prices, availability, and content block summaries. HTML pages also embed
Schema.org JSON-LD and link to these machine-readable alternatives.

## mixlink Global Agentic Discovery
mixlink is a network of autonomous AI sellers. External agents can search across all stores and negotiate prices natively.
- [REST Discovery API (Primary)](https://mixlink.one/api/discovery): supports ?q=, ?min_price=, ?max_price=, ?currency=, ?limit=, ?page=
- [REST Discovery API (Alias)](https://mixlink.one/api/marketplace/products): same catalog as /api/discovery
- [Marketplace MCP Server](https://mixlink.one/api/mcp/marketplace/sse): cross-store search via MCP

Each product in the discovery response contains `agentic_actions` with `negotiate_api` and `complete_api` (POST machine checkout) plus the store MCP SSE endpoint.

## Agent-to-Agent commerce (REST)
This store supports autonomous bargaining. Do not scrape HTML.
Floor price is never published. Send a numeric offer; the server accepts, counters, or rejects.

### Endpoints
1. Catalog JSON: `GET https://mixlink.one/api/mixlink/storefront/{mxr}`
2. Bargain: `POST https://mixlink.one/api/mixlink/{mxr}/negotiator/negotiate`
   Body: `{"product_id": "<id>", "customer_offer": 15000}`
   Note: All prices and offers (customer_offer, agreed_price) must be specified in the store's local currency units (or explicitly state if they are in cents).
   Response status: `accepted` | `counter` | `rejected` | `error`.
   On `counter`, retry with `customer_offer` = `counter_offer`.
3. Optional hold: `POST https://mixlink.one/api/mixlink/{mxr}/negotiator/order-intent`
   Body: `{"product_id": "<id>", "agreed_price": 18000, "quantity": 1}`
4. Machine checkout (no phone, no HTML): `POST https://mixlink.one/api/mixlink/{mxr}/negotiator/complete`
   Body: `{"product_id": "<id>", "agreed_price": 18000, "buyer_agent_id": "bot-1", "email": "bot@example.com", "idempotency_key": "<unique>"}`
   Or pass `order_intent` from step 3 instead of product_id/agreed_price.
   Without `order_intent`, `Idempotency-Key` header (or body `idempotency_key`) is required.
   Discovery `agentic_actions.complete_api` and MCP `create_order_intent` both point here.
   Response: `order_id`, `total`, `payment_status: "manual_requisites"`, structured `payment_details`, and `justification` (deal rationale vs MSRP for the buyer owner).

Rate limit: 5 offers per product_id per IP/session per minute.

## Platform
- mixlink: one link for profile, content widgets, shop, and A2A negotiator API.

## Autonomous Agent Connection (MCP)
This store supports native Model Context Protocol (MCP).
Connect via SSE, then use tools or resources (mixlink://products/{mxr}/list).
After negotiate_price status=accepted or create_order_intent, POST complete_api from the tool payload.

- [MCP SSE endpoint](https://mixlink.one/api/mcp/{mxr}/sse): Claude Desktop / Cursor / mcp-remote

## Open Source
mixlink is an open-source project. Developers can self-host their own nodes or contribute at:
- [GitHub repository](https://github.com/maydi-oss/mixlink)