Skip to content
Back to search
100
MCP live v1.2.0 MCP 2025-11-25 streamable-http

Kifly — Agentic Commerce & Payments

ai.kifly/mcp

Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.

Watch this dependency Share evidence report
Uptime
75.0%
4 direct probes · 30d
Response
2094ms
last probe
Tools
22
callable
Resources
10
readable
Prompts
1
available
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
22 tools, 10 resources, 1 prompts returned.
pass 3 or more catalogue items 10/10
33 items in total; 3 or more earns these points.
pass Describes itself 10/10
88 characters; more than 30 earns these points.

Tools · 22

search_products

Search or browse Kifly's product catalog across every seller on the network. Multilingual semantic search (100+ languages); omit `q` to browse recent listings. Several items? Pass `q` as an array (up …

create_cart

Create a new shopping cart on Kifly. **For network (cross-seller) tokens you MUST pass `seller_handle`** — each cart is bound to exactly one seller. Get the handle from search_products results (every …

add_to_cart

Requires `cart:write`, or no key: send `meta.ucp-agent.profile`. Add a product variant to an existing cart. Use the variant_id from search_products results. Returns full cart state including item_ids …

get_cart

Inspect the current state of a cart — line items, quantities, prices, and shipping address. Each item includes an `item_id` you can pass to `update_cart_item` to change quantity or remove the item. Ca…

update_cart_item

Requires `cart:write`, or no key: send `meta.ucp-agent.profile`. Change the quantity of a line item in an open cart, or remove it entirely. Set `quantity` to 0 to remove the item. Get the `item_id` fr…

set_shipping_address

Requires `cart:write`, or no key: send `meta.ucp-agent.profile`. Persist a shipping address on the cart and confirm the seller can deliver to it. **Call BEFORE `checkout`.** Returns `delivery_eligible…

quick_buy

Requires `cart:write` scope. Create a cart, add items, and set the shipping address in ONE call — the fast path when you already know the seller, the exact variant(s), and the buyer's address (e.g. a …

checkout

Requires `checkout:write` or `checkout:link`, or no key: send `meta.ucp-agent.profile` for the same payment link. **Checkout is always human-in-the-loop: it returns a link the buyer opens and confirms…

register_buyer

Start registering a buyer so they can be recognized across future purchases without re-entering their details. Takes the buyer's email and name and always emails a 6-digit verification code — the resp…

request_buyer_code

Send a 6-digit verification code to a **returning** buyer's email so they can prove the account is theirs and recover their saved name + shipping address on this connection — without pasting any token…

verify_buyer

Verify the 6-digit code a returning buyer received by email (from `request_buyer_code`). On success returns `{ buyer_token, buyer_profile_id }` — pass the `buyer_token` to `get_buyer_profile` to auto-…

get_buyer_profile

Retrieve a repeat buyer's saved name, email, and default shipping address, given their `buyer_token`. Use them to auto-fill `set_shipping_address`, and pass the token to `checkout` so Stripe pre-fills…

list_orders

List a returning buyer's recent orders and their current fulfillment status — use this in a NEW session to answer 'did my order ship?' / 'where's my package?' when you don't have the original `session…

save_buyer_address

Save a shipping address to the buyer's Kifly profile so it auto-fills on future purchases. **Call this after a successful checkout if `get_buyer_profile` returned `default_shipping_address: null`.** T…

submit_feedback

Send structured feedback to the Kifly team. **No API key required** — send `meta.ucp-agent.profile` and this works with no credential at all. **Call after a confusing response, a dead-end, or a succes…

request_feature

Submit the buyer's **product/feature request** to the Kifly team. Use this when the buyer wishes Kifly *itself* did something it doesn't — a missing capability, a rough flow, an idea to improve the pl…

get_seller

**Call first when the user names a store or its website**: it says whether Kifly carries it before you open a browser. Returns the seller's public profile: location, storefront URL, delivery fee and c…

get_policies

The seller's published returns, shipping and warranty policy, in their own words. **Call before telling a buyer what happens after purchase** — if it is not here, say so; never infer a typical policy.…

list_sellers

List all active sellers on the Kifly network. **Requires a network token (kfn_live_…).** Returns each seller's handle, name, city, region, delivery coverage (`nationwide:true` or a `states` list), del…

get_platform_limits

Returns the current platform-enforced cart limits: `max_item_quantity` (per-line-item ceiling), `max_cart_total_cents`, and `max_cart_total_usd`. Call this once at session start before building a larg…

order_status

No key needed for your own session: send the profile you checked out with. Check the status of a Stripe checkout session. Poll every 5 seconds after checkout until status is 'paid', 'shipped', or 'fai…

get_help

Get unstuck. Returns Kifly's website and support email for the BUYER, plus how to report the problem to Kifly's engineers yourself. Call this if you are stuck, hit an unresolvable error, or the buyer …

Resources · 10

docs_playbook

The lookup-first shopping flow: check a named store with get_seller(domain) before opening a browser, then search, cart, delivery, checkout and order status.

kifly://docs/playbook
platform_limits

Current cart constraints: max quantity per line item and max cart total (cents + USD). Read before starting a purchase flow to avoid rejection mid-checkout.

kifly://platform/limits
docs_delivery

How delivery_coverage works: the four coverage cases (nationwide, state list, not-configured, merchant-managed), where cities are capped, and how eligibility and fees are quoted.

kifly://docs/delivery
docs_search_response

Field-level reference for search_products / browse results: the kifly:sellers map, the three delivery-coverage cases, variant and option-axis alignment, capped fields, and every kifly: extension. Fetc…

kifly://docs/search-response
docs_checkout_response

Field-level reference for checkout results: the three payment_rail outcomes and what each does and does not carry, the directory handoff object, buyer_token_status, and every refusal code with its ret…

kifly://docs/checkout-response
docs_buyer_identity

The email-code sequence that recovers a returning buyer's saved name, email and shipping address (request_buyer_code → verify_buyer → get_buyer_profile), the one-click sign-in alternative, and what to…

kifly://docs/buyer-identity
docs_rest

The HTTP surface: the UCP-Agent header in both accepted wire forms, the endpoints open without a credential, idempotency, and the error envelope. Read this if a request is refused and you cannot tell …

kifly://docs/rest
docs_errors

Every stable error `code` the API returns, what causes it, and whether it is retryable. Read this before treating a failure as permanent.

kifly://docs/errors
docs_mcp

Which credential fits what you are building, what a tokenless agent can reach, and the recommended purchase flow.

kifly://docs/mcp
search_results_view

Interactive product cards for search_products results.

ui://kifly/search-results.html

Prompts · 1

shop_at_store

Buy from a store you name (its website or its name) through Kifly, lookup first.

How to use

Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://kifly.ai/api/mcp

Cursor or Cline: add to your MCP config:

{
  "mcpServers": {
    "kifly_\u2014_agentic_commerce_\u0026_payments": {
      "url": "https://kifly.ai/api/mcp",
      "transport": "streamable-http"
    }
  }
}