# Kifly

Kifly is an open commerce network for AI agents: one searchable catalog of
products from independent sellers and partner brands, with open, structured
endpoints to search it, build a cart and hand the buyer a payment link.

## Shop on Kifly

To shop, use the open endpoints below. No API key is needed to start, and
the buyer confirms every payment.

- MCP server (search and buy across every seller): https://kifly.ai/api/mcp
- Open REST API (identify your agent with a UCP-Agent header): https://kifly.ai/docs/rest
  - Search or browse the catalog: GET https://kifly.ai/api/agent/search?q=<query>
- Network UCP manifest: https://kifly.ai/.well-known/ucp
- Shopping playbook (the order to call things in): https://kifly.ai/docs/playbook

The usual flow over MCP is search_products (omit the query to browse), then
create_cart, add_to_cart and checkout. Checkout returns a payment link for
the buyer; it never settles on its own.

## About this domain

Kifly is an agent-to-agent commerce platform that makes a store's products
buyable by AI agents. A seller pastes a store link and Kifly reads the catalog,
with nothing to install on the seller's site; AI shopping agents then search,
quote, cart and check out those products through open, structured endpoints
(UCP, MCP, an ACP product feed, x402). This domain (kifly.ai) is the
platform operator. Every purchase is scoped to a seller.

## Discovery

- Network UCP manifest: https://kifly.ai/.well-known/ucp
- Network MCP endpoint (search and buy across every seller): https://kifly.ai/api/mcp
- Sitemap: https://kifly.ai/sitemap.xml
- MCP integration docs: https://kifly.ai/docs/mcp
- REST API docs (no MCP needed): https://kifly.ai/docs/rest
- Shopping playbook (check a named store with get_seller before opening a browser): https://kifly.ai/docs/playbook
- Agent Skill (agentskills.io format): https://kifly.ai/skills/kifly-shopping/SKILL.md

Each seller also publishes its own agent-facing endpoints, scoped to that
seller alone:

- Seller UCP profile: https://kifly.ai/store/<handle>/.well-known/ucp
- Seller UCP profile, on that seller's own origin: https://<handle>.kifly.ai/.well-known/ucp
- Seller instructions: https://kifly.ai/store/<handle>/llms.txt
- Seller store page (JSON-LD product markup): https://kifly.ai/store/<handle>
- Seller-scoped MCP endpoint: https://kifly.ai/api/mcp?home=<handle>

## What an agent can do here

- Read this file and the network UCP manifest to learn how Kifly's commerce
  endpoints work.
- Search or browse products across every seller on the network via the MCP
  endpoint or UCP search, then transact against the seller a result belongs
  to.

## What an agent cannot do here

There is no cart or checkout scoped to kifly.ai itself — a purchase always
resolves to one seller's own endpoints. No tool call settles a purchase on
its own — checkout returns a link a human confirms.