MCP for AI assistants
Find packages, check your card balance and track orders from an AI assistant. Review a quote before ordering.
MCP endpoint
https://www.kyquant.com/api/mcp
Connect your client
Use a site VIP card as a Bearer token. No browser login or OAuth flow is required. Keep the card in a trusted local client or server.
Use a remote Streamable HTTP client with custom Authorization headers.
{
"mcpServers": {
"zfensi": {
"url": "https://www.kyquant.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:ZFENSI_CARD}"
}
}
}
}Store your card in the local ZFENSI_CARD environment variable. Examples contain placeholders only.
Quote before ordering
- Find a package and check available funds.
- Review the quoted target, amount, currency and expiry.
- After approval, submit its quote ID, a maximum amount and a UUID.
- Track progress using the original order number.
Example assistant prompt
Check my available balance and Instagram packages, then quote the account I provide. Show the target, package quantity and total price. Wait for my approval before ordering. Reuse the same request ID after a timeout.
Available tools
| Tool | Connection and usage |
|---|---|
list_services | Find current packages with pagination |
get_balance | Read balance and available funds |
quote_order | Validate a target and get an uncharged quote |
create_order | Place a paid order within the quoted amount limit |
get_order_status | Track original order numbers |
HTTP initialization example
curl 'https://www.kyquant.com/api/mcp' \
-H "Authorization: Bearer $ZFENSI_CARD" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0.0"}}}'Requests and billing
- Quotes create no order and charge nothing. They expire after 5 minutes.
- max_amount uses currency minor units: 100 CNY fen equals 1 yuan. Requote after a change or expiry.
- After a timeout, reuse the identical quote_id, request_id and parameters. A new UUID means another paid order.
- Choose an exact fixed package quantity. Use comment_input or hashtag_input for text parameters.
- Only this card’s orders are accessible. Cancellation does not mean refunded; unknown start_count and remains are null.
- Supports MCP 2025-11-25, 2025-06-18 and 2025-03-26. Stateless JSON responses; no persistent SSE sessions.
- Up to 60 tool calls per card per minute. Respect Retry-After on HTTP 429; wait a minute after a RATE_LIMITED tool error.
- Maximum request size: 64 KiB. All tools require Bearer authentication; disabled or expired cards cannot call them.
