MCP / API Docs

Connect an AI agent to AliceTears tools over MCP

1. Create an API token

Log in, then create a personal API token. It's shown once — copy it somewhere safe.

Create a token →
2. Connect your MCP client

Point your MCP-compatible client (Claude Desktop, Claude Code, etc.) at the endpoint below with your token as a Bearer header.

claude_desktop_config.json
{
  "mcpServers": {
    "alicetears": {
      "url": "https://alicetears.com/api/mcp",
      "headers": {
        "Authorization": "Bearer selat_..."
      }
    }
  }
}
3. Available tools
translate_text

Translate text between Thai, English, Traditional Chinese, Japanese and Korean. Free, capped at 20/day per account.

  • text · string — Text to translate
  • target · "th" | "en" | "zh-TW" | "ja" | "ko" — Target language code
generate_caption

Generate 3 social caption options plus hashtags for a topic. Costs coins per call, billed to the account's balance.

  • topic · string — What the post is about
  • platform · "instagram" | "tiktok" | "twitter" | "youtube" — Optional
  • tone · "playful" | "professional" | "hype" | "heartfelt" — Optional
generate_stream_title

Generate 5 live-stream title options, tags, and a short description for a topic/game. Costs coins per call, billed to the account's balance.

  • topic · string — The game or topic being streamed
  • platform · "twitch" | "youtube" — Optional
  • vibe · "hype" | "chill" | "funny" | "serious" — Optional
generate_greeting

Generate 5 greeting/wish message options for an occasion, optionally personalized with a recipient name. Costs coins per call, billed to the account's balance.

  • occasion · "birthday" | "newyear" | "wedding" | "songkran" | "graduation" | "thankyou" | "getwell" | "farewell" — The occasion for the greeting
  • recipientName · string — Optional
  • tone · "warm" | "formal" | "funny" | "poetic" — Optional
suggest_envelope_amount

Suggest a Thai social gift-money (envelope) amount range for an event, based on event type and relationship. Social-etiquette guidance, not financial advice. Costs coins per call, billed to the account's balance.

  • event · "wedding" | "ordination" | "funeral" | "newborn" | "housewarming" | "openingceremony" | "chinesenewyear" | "graduation" — The event the envelope is for
  • relationship · "family" | "closefriend" | "friend" | "colleague" | "acquaintance" | "boss" — Relationship to the host/celebrant
  • notes · string — Optional
detect_ai_text

Check whether text came from AI: per-segment labels (human, AI-generated, AI-translated, AI-edited) with a percentage per type. 5 free checks/day (shared with the website), then priced by the text's token count.

  • text · string — Text to check (50–10,000 characters)
  • locale · "th" | "en" | "zh-TW" — Optional

More tools are added over time — call tools/list to see the current set.

4. Or call it directly (curl)
curl
curl -X POST https://alicetears.com/api/mcp \
  -H "Authorization: Bearer selat_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "translate_text",
      "arguments": { "text": "สวัสดีค่ะ", "target": "en" }
    }
  }'