Agent Integration

Connect to Claude

One-click install the Kifly MCP server into Claude Desktop or Claude.ai.

You'll be prompted for your Kifly agent key. Generate one at /dashboard/api-keys.

Kifly MCP Integration

Connect any MCP-compatible agent to the Kifly catalog.

Endpoint

https://kifly.ai/api/mcp

Remote server, StreamableHTTP transport. Your MCP host lists the tools and their parameters when it connects.

Authentication

Pick the credential by what you're building. The wrong one doesn't error, it just shows you less.

You're building	Use	Sees
An agent you want to try right now	Nothing. Identify your agent (below)	The whole network
An integration against your own store	Seller API key (`kfa_live_`)	Your own store only. Cannot be upgraded to network scope.
A buyer agent acting for a person	OAuth 2.1	The whole network
A headless agent, no human at connect time	Network key (`kfn_live_`)	The whole network

No credential

Send your agent's UCP profile URL in meta:

{ "meta": { "ucp-agent": { "profile": "https://your-agent.example/.well-known/ucp" } } }

This covers search, sellers, carts and the payment link. Buyer identity and order history need a credential. The open tool list and limits are published at /.well-known/ucp.

Seller API key (`kfa_live_`)

Create one in the seller dashboard under Developer → API Keys. It authenticates as your store and only returns your catalog.

Authorization: Bearer kfa_live_xxxxxxxxxxxxxxxx

OAuth 2.1

Discovery at https://kifly.ai/.well-known/oauth-authorization-server, with dynamic client registration at https://kifly.ai/oauth/register. No Kifly seller account needed to register a client. PKCE S256 required. Hosts like claude.ai negotiate this automatically.

Network key (`kfn_live_`)

For headless agents. Create one from a Kifly developer account, or via POST /api/developer/network-keys while signed in.

Authorization: Bearer kfn_live_xxxxxxxxxxxxxxxx

Connecting your host

claude.ai: use the install button at the top of this page, or Anthropic's custom connector guide.
Claude Desktop: Anthropic's guide.
Other hosts: add the server URL above and, if your host takes headers, your Authorization header.

Tools

Area	Tools
Discovery	`search_products`, `get_seller`, `list_sellers`, `get_policies`
Cart	`create_cart`, `add_to_cart`, `get_cart`, `update_cart_item`, `set_shipping_address`, `quick_buy`
Checkout	`checkout`, `order_status`
Buyer	`register_buyer`, `request_buyer_code`, `verify_buyer`, `get_buyer_profile`, `save_buyer_address`, `list_orders`
Support	`get_help`, `get_platform_limits`, `submit_feedback`, `request_feature`

checkout returns a payment link the buyer opens and confirms. No tool completes a purchase on its own.

Typical flow

search_products
create_cart, then add_to_cart
set_shipping_address
checkout and give the buyer the link
order_status until paid

Requests are rate-limited; over the limit you get 429 with Retry-After. See Platform Limits and the Error Reference.