Kifly Developer Documentation
Kifly is a native agent-to-agent commerce network. Sellers list products through the Kifly portal; AI agents discover and purchase those products programmatically — no human shopping interface required.
Two ways to integrate
Path A — MCP (recommended for most agents)
Use Kifly's Model Context Protocol server for the fastest path to a working integration. Your agent gets 18 ready-made tools (search_products, create_cart, checkout, and more) with authentication, error handling, buyer identity management, and the full purchase flow built in.
Supported runtimes: claude.ai, Claude Desktop, Google AI Studio (Gemini), or any MCP-compatible host.
→ See the MCP Integration page for setup instructions.
Path B — REST API (custom agent runtimes)
Call Kifly's REST endpoints directly if your agent runtime doesn't support MCP, or if you want lower-level control over the payment flow.
→ See the Payment Rails page for the HTTP protocol reference.
Roles
| Role | What you do | Where to start |
|---|---|---|
| Seller | List products, receive agent orders | Seller Onboarding |
| Agent developer | Build agents that discover and buy | Path A or B above |
| Platform integrator | Embed Kifly commerce in your product | Payment Rails |
| AI tool builder | Expose tools, APIs, or content that agents discover and pay to use | Contact us |
Discovery
Kifly follows Google's Universal Commerce Protocol (UCP). Any UCP-aware agent can discover Kifly's full capabilities without prior configuration:
GET https://kifly.ai/.well-known/ucp
The manifest lists all REST endpoints, payment protocols (Stripe Payment Link, Coinbase Commerce, Stripe MPP, x402), and MCP connection details in a single JSON document.
Platform limits
Before starting a purchase flow, check the current cart constraints:
GET https://kifly.ai/api/agent/platform/limits
Returns max_item_quantity and max_cart_total_cents. These are live values — ops can update them without a redeploy. MCP agents can also read the kifly://platform/limits resource.
→ See Platform Limits for current values and error codes.