518fans.com
English
2026 双11.11 存费 增额翻倍注册领¥10 · 充值赠费翻倍 · 至11.20
See offers

Search services

Browse services

Navigation

Shop/MCP for AI assistants

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.518fans.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.518fans.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

  1. Find a package and check available funds.
  2. Review the quoted target, amount, currency and expiry.
  3. After approval, submit its quote ID, a maximum amount and a UUID.
  4. 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

ToolConnection and usage
list_servicesFind current packages with pagination
get_balanceRead balance and available funds
quote_orderValidate a target and get an uncharged quote
create_orderPlace a paid order within the quoted amount limit
get_order_statusTrack original order numbers

HTTP initialization example

curl 'https://www.518fans.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.

Alipay