TapTap Open API MCP Server

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The multiplayer code to check"
    }
  },
  "required": [
    "code"
  ]
}

{
  "type": "object",
  "properties": {
    "clear_token": {
      "type": "boolean",
      "description": "Clear OAuth token file (default: true)"
    },
    "clear_cache": {
      "type": "boolean",
      "description": "Clear app selection cache (default: true)"
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "developerId": {
      "type": "number",
      "description": "The developer id of the app. Leave empty if the user has not specified a particular ID"
    },
    "appName": {
      "type": "string",
      "description": "The name of the app"
    },
    "genre": {
      "type": "string",
      "description": "Game genre (e.g. rpg, casual, action, strategy, simulation, etc.)"
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Leaderboard title/name (REQUIRED)"
    },
    "period_type": {
      "type": "string",
      "description": "Reset period: \"always\" (default), \"daily\", \"weekly\", \"monthly\"",
      "enum": [
        "always",
        "daily",
        "weekly",
        "monthly"
      ]
    },
    "score_type": {
      "type": "string",
      "description": "Score type: \"numeric\" (default), \"time\"",
      "enum": [
        "numeric",
        "time"
      ]
    },
    "score_order": {
      "type": "string",
      "description": "Score order: \"desc\" (high to low, default), \"asc\" (low to high)",
      "enum": [
        "desc",
        "asc"
      ]
    },
    "calc_type": {
      "type": "string",
      "description": "Calculation type: \"sum\" (default), \"best\", \"latest\"",
      "enum": [
        "sum",
        "best",
        "latest"
      ]
    },
    "display_limit": {
      "type": "number",
      "description": "Display limit (optional, default 100)"
    },
    "period_time": {
      "type": "string",
      "description": "Reset time like \"08:00:00\" (required if period_type is not \"always\")"
    }
  },
  "required": [
    "title"
  ]
}

{
  "type": "object",
  "properties": {
    "developer_id": {
      "type": "number",
      "description": "Developer ID (optional, will be auto-filled from context or cache)"
    },
    "app_id": {
      "type": "number",
      "description": "App ID (optional, will be auto-filled from context or cache)"
    },
    "contents": {
      "type": "string",
      "description": "Share description content (REQUIRED). STRICT LIMIT: max 21 UTF-8 characters including spaces and punctuation. Example: \"分享游戏获得奖励\" (12 chars). This is the text shown in share panel."
    },
    "remark": {
      "type": "string",
      "description": "Internal remark/note for template management (REQUIRED, max 100 characters). Not shown to users, only for developer reference. Used to identify and manage templates."
    }
  },
  "required": [
    "contents",
    "remark"
  ]
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "number",
      "description": "App ID to check status for"
    },
    "ignore_cache": {
      "type": "boolean",
      "description": "If true, force refresh data from server regardless of cache TTL. Default false."
    }
  },
  "required": [
    "app_id"
  ]
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Optional start date in YYYY-MM-DD format."
    },
    "end_date": {
      "type": "string",
      "description": "Optional end date in YYYY-MM-DD format."
    }
  }
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Forum flow type. Default: \"feed\"."
    },
    "sort": {
      "type": "string",
      "description": "Sort mode. Default: \"default\"."
    },
    "from": {
      "type": "number",
      "description": "Pagination start offset. Default: 0."
    },
    "limit": {
      "type": "number",
      "description": "Page size. Default: 10, max: 20.",
      "minimum": 1,
      "maximum": 20
    },
    "group_label_id": {
      "type": "number",
      "description": "Optional forum sub-group label ID."
    }
  }
}

{
  "type": "object",
  "properties": {
    "ignore_cache": {
      "type": "boolean",
      "description": "If true, force refresh data from server regardless of cache TTL. Default false."
    }
  }
}

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Optional start date in YYYY-MM-DD format."
    },
    "end_date": {
      "type": "string",
      "description": "Optional end date in YYYY-MM-DD format."
    }
  }
}

{
  "type": "object",
  "properties": {
    "sort": {
      "type": "string",
      "description": "Review sort mode. Default: \"new\".",
      "enum": [
        "new",
        "hot",
        "spent"
      ]
    },
    "from": {
      "type": "number",
      "description": "Pagination start offset. Default: 0."
    },
    "limit": {
      "type": "number",
      "description": "Page size. Default: 10, max: 10.",
      "minimum": 1,
      "maximum": 10
    },
    "is_collapsed": {
      "type": "boolean",
      "description": "Whether to query collapsed reviews."
    },
    "filter_platform": {
      "type": "string",
      "description": "Optional platform filter.",
      "enum": [
        "mobile",
        "pc",
        "web"
      ]
    }
  }
}

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Optional start date in YYYY-MM-DD format."
    },
    "end_date": {
      "type": "string",
      "description": "Optional end date in YYYY-MM-DD format."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "How many feedback records to pull (1-10, default 3)."
    },
    "status": {
      "type": "number",
      "description": "Feedback status filter:\n- 0: all\n- 1: unprocessed\n- 2: processed\n\nWhen fetch_and_mark_processed=true, status filter will be ignored by server."
    },
    "fetch_and_mark_processed": {
      "type": "boolean",
      "description": "Pull unprocessed records and mark them processed on server. Default true. Set false only for explicit read-only requests. When true, status is ignored."
    },
    "download_assets": {
      "type": "boolean",
      "description": "Whether to download feedback JSON/screenshot/log files to local workspace. Default true."
    },
    "moment_id": {
      "type": "string",
      "description": "Optional. Filter to a single feedback by moment_id. Accepts either a pure numeric ID (e.g. \"795659996946762795\") or a full TapTap moment URL (e.g. \"https://www.taptap.cn/moment/795659996946762795\") — the handler will extract the numeric ID. When provided, server returns only the matching record, and fetch_and_mark_processed is forced to false (read-only single lookup). MUST be passed as a string to preserve precision for large IDs."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "target_environment": {
      "type": "string",
      "enum": [
        "rnd",
        "production"
      ],
      "description": "Target environment to explain. Use rnd for testing/internal preview. Default: rnd."
    },
    "package_tag": {
      "type": "string",
      "description": "Optional npm package tag or version to show in examples, such as beta, latest, or 1.21.0. Default: current package without tag."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "developer_id": {
      "type": "number",
      "description": "Developer ID (optional, will be auto-filled from context or cache)"
    },
    "app_id": {
      "type": "number",
      "description": "App ID (optional, will be auto-filled from context or cache)"
    },
    "template_code": {
      "type": "string",
      "description": "Template code (REQUIRED). This is the identifier returned by create_share_template. Used as templateId parameter in client-side tap.showShareboard({ templateId: \"...\" }) API."
    }
  },
  "required": [
    "template_code"
  ]
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "leaderboardId": {
      "type": "string",
      "description": "Leaderboard ID"
    },
    "limit": {
      "type": "number",
      "description": "Max entries (default 10)"
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "number",
      "description": "Target review ID to like."
    }
  },
  "required": [
    "review_id"
  ]
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of apps to show in the human-readable preview. Defaults to 40, max 100."
    },
    "offset": {
      "type": "number",
      "description": "Number of apps to skip before showing the preview. Use the suggested next offset to continue."
    }
  }
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (optional, default 1)"
    },
    "page_size": {
      "type": "number",
      "description": "Page size (optional, default 10)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "developer_id": {
      "type": "number",
      "description": "Developer ID (optional, will be auto-filled from context or cache)"
    },
    "app_id": {
      "type": "number",
      "description": "App ID (optional, will be auto-filled from context or cache)"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination (optional, default 1, starts from 1)"
    },
    "page_size": {
      "type": "number",
      "description": "Number of items per page (optional, default 10)"
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "gamePath": {
      "type": "string",
      "description": "**MUST be a relative path** to the H5 game build output directory.\n\n✅ Correct: \"dist\", \"build\", \"output\", \".\"\n❌ Wrong: \"/workspace/dist\", \"/tmp/build\" (absolute paths not allowed)\n\n**BEHAVIOR:**\n- If user specifies directory, pass that relative path\n- If user doesn't specify, ASK: \"请问游戏构建产物在哪个目录？（如 dist、build）\"\n- If index.html is in project root, pass \".\" or leave empty\n- DO NOT guess - confirm with user if unsure"
    },
    "genre": {
      "type": "string",
      "description": "If user provides a specific game genre, use it directly.\n                 If user is unsure or doesn't specify, analyze the code files, game mechanics, UI elements, and gameplay features in the project directory to determine the most appropriate game genre.\n                 Available genres keys: rpg, casual, action, strategy, simulation, trivia, arcade, adventure, card, sports, racing, puzzle, educational, music, word, board, and the chinese name of the genre is 角色扮演, 休闲, 动作, 策略, 模拟, 益智, 街机, 冒险, 卡牌, 体育, 竞速, 知识问答, 教育, 音乐, 文字, 桌面和棋类.\n                 When analyzing, consider game rules, player interactions, visual elements, and core gameplay loops.\n                 If still uncertain after analysis, default to 'casual' as fallback."
    }
  }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Leaderboard database ID (required)"
    },
    "publish": {
      "type": "boolean",
      "description": "true=publish (public), false=whitelist only (required)"
    }
  },
  "required": [
    "id",
    "publish"
  ]
}

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "number",
      "description": "Target review ID to reply to."
    },
    "contents": {
      "type": "string",
      "description": "Official reply content to send."
    },
    "reply_comment_id": {
      "type": "number",
      "description": "Optional comment ID if replying to a specific review reply."
    },
    "confirm_high_risk": {
      "type": "boolean",
      "description": "Only set to true after the user explicitly confirms sending a MEDIUM/HIGH risk draft."
    }
  },
  "required": [
    "review_id",
    "contents"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keyword (REQUIRED). Examples: \"showShareboard\", \"onShareMessage\", \"share panel\", \"分享\", \"template\", etc."
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "developer_id": {
      "type": "number",
      "description": "Developer ID to select (required)"
    },
    "app_id": {
      "type": "number",
      "description": "App/Game ID to select (required)"
    }
  },
  "required": [
    "developer_id",
    "app_id"
  ]
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "developerId": {
      "type": "number",
      "description": "The developer id of the app"
    },
    "appId": {
      "type": "number",
      "description": "The app id of the game"
    },
    "appName": {
      "type": "string",
      "description": "The name of the app"
    },
    "genre": {
      "type": "string",
      "description": "Game genre"
    },
    "description": {
      "type": "string",
      "description": "The description of the app"
    },
    "chattingLabel": {
      "type": "string",
      "description": "The name of the QQ group"
    },
    "chattingNumber": {
      "type": "string",
      "description": "The number of the QQ group"
    },
    "screenOrientation": {
      "type": "number",
      "description": "The screen orientation of the app, 1: portrait, 2: landscape"
    },
    "icon": {
      "type": "string",
      "description": "Icon URL (JPG/PNG, minimum 512x512 pixels)"
    },
    "banner": {
      "type": "string",
      "description": "Banner image URL (JPG/PNG, max 4MB, minimum 1920x1080 pixels)"
    },
    "screenshots": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Screenshot URLs (up to 4 images). Requirements: 1) Landscape: aspect ratio 8:3 to 8:5, min 1280x720px; 2) Portrait: aspect ratio 3:8 to 5:8, min 720x1280px; 3) All images must have the same aspect ratio as the first one."
    },
    "trialNote": {
      "type": "string",
      "description": "Developer notes for review (trial_note)"
    }
  },
  "required": [
    "developerId",
    "appId"
  ]
}

{
  "type": "object",
  "properties": {
    "gamePath": {
      "type": "string",
      "description": "**MUST be a relative path** to the H5 game build output directory.\n\n✅ Correct: \"dist\", \"build\", \"output\", \".\"\n❌ Wrong: \"/workspace/dist\", \"/tmp/build\" (absolute paths not allowed)\n\nUse the same path confirmed in prepare_h5_upload step."
    },
    "genre": {
      "type": "string",
      "description": "If user provides a specific game genre, use it directly.\n                 If user is unsure or doesn't specify, analyze the code files, game mechanics, UI elements, and gameplay features in the project directory to determine the most appropriate game genre.\n                 Available genres keys: rpg, casual, action, strategy, simulation, trivia, arcade, adventure, card, sports, racing, puzzle, educational, music, word, board, and the chinese name of the genre is 角色扮演, 休闲, 动作, 策略, 模拟, 益智, 街机, 冒险, 卡牌, 体育, 竞速, 知识问答, 教育, 音乐, 文字, 桌面和棋类.\n                 When analyzing, consider game rules, player interactions, visual elements, and core gameplay loops.\n                 If still uncertain after analysis, default to 'casual' as fallback."
    }
  }
}

{
  "type": "object",
  "properties": {
    "filePath": {
      "type": "string",
      "description": "Local file path to the image (relative to workspace or absolute). Supports JPG, PNG, GIF, WebP."
    },
    "base64Data": {
      "type": "string",
      "description": "Base64 encoded image data. Can include data URL prefix (e.g., \"data:image/png;base64,...\") or be raw base64 string."
    },
    "filename": {
      "type": "string",
      "description": "Optional filename for the uploaded image. If not provided, will be derived from filePath or default to \"image.png\"."
    }
  }
}