Bragproof

← Reports

@taptap/instant-games-open-mcp

Starts with no setup1.24.14npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 2 of 5 tools tried
Contacts while installing and starting: nothing

52tools listed
0hosts contacted
0files written
0.1 sto start
210dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y -p @taptap/instant-games-open-mcp@1.24.14 instant-games-open-mcp

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 2 returned a result.

get_current_app_infoReturned a result under 0.1 s · 129 characters
get_environment_switch_guideReturned a result under 0.1 s · 1,144 characters
list_developers_and_appsNo usable answer MCP error -32603: 🔐 缺少认证信息 当前没有有效的 TapTap 认证信息。 🔐 需要 TapTap 授权 请按以下步骤操作: 1️⃣ 打开授权链接: https://www.taptap.cn/tap-qrcode?scene=mcp_auth&code=https%3A%2F%2
get_current_app_review_overviewNo usable answer MCP error -32603: 🔐 缺少认证信息 当前没有有效的 TapTap 认证信息。 🔐 需要 TapTap 授权 请按以下步骤操作: 1️⃣ 打开授权链接: https://www.taptap.cn/tap-qrcode?scene=mcp_auth&code=https%3A%2F%2
get_current_app_community_overviewNo usable answer MCP error -32603: 🔐 缺少认证信息 当前没有有效的 TapTap 认证信息。 🔐 需要 TapTap 授权 请按以下步骤操作: 1️⃣ 打开授权链接: https://www.taptap.cn/tap-qrcode?scene=mcp_auth&code=https%3A%2F%2

During the calls (not necessarily because of them) it first contacted: accounts.tapapis.cn.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

30 tools with commands in capitals or very long text
  • Gives the agent orders in get_current_app_info: including developer_id, app_id, miniapp_id, and app name. **CRITICAL: Call this tool FIRST before executing any leaderboard operations (create_leaderboard, list_leaderb
  • Gives the agent orders in list_developers_and_apps: s total counts; call again with offset/limit to continue. **CRITICAL: Show the returned preview/counts to the user and explicitly ASK them to choose which app to use or
  • Gives the agent orders in select_app: les (leaderboard, H5, current-app community tools, etc.). **IMPORTANT: Only call this tool AFTER the user has explicitly confirmed which app they want to use. DO NOT cal
  • Gives the agent orders in get_current_app_store_overview: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in get_current_app_review_overview: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS verify the selected app context. Get review o
  • Gives the agent orders in get_current_app_community_overview: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS verify the selected app context. Get communit
  • Gives the agent orders in get_current_app_store_snapshot: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in get_current_app_forum_contents: **PREREQUISITE: An app MUST be selected first.** Read forum contents for the currently selected app only. Use this to inspect t
  • Gives the agent orders in get_current_app_reviews: **PREREQUISITE: An app MUST be selected first.** List reviews for the currently selected app only. Use this before like/reply a
  • Gives the agent orders in like_current_app_review: **PREREQUISITE: An app MUST be selected first.** Like a specific review for the currently selected app. **IMPORTANT: Before cal
  • Gives the agent orders in reply_current_app_review: **PREREQUISITE: An app MUST be selected first.** Reply to a specific review as the official app identity. **CRITICAL: Always ma
  • Gives the agent orders in get_leaderboard_integration_guide: /add leaderboard功能. Returns complete step-by-step workflow. CRITICAL: Emphasizes NO SDK installation - tap is global object. Call this BEFORE making any implementation
  • Gives the agent orders in create_leaderboard: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in list_leaderboards: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in publish_leaderboard: **PREREQUISITE: An app MUST be selected first.** Publish leaderboard or set to whitelist-only mode. Before calling this tool, e
  • Gives the agent orders in prepare_h5_upload: H5 game ('发布', '上传', '部署'). **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify a
  • Gives the agent orders in upload_h5_game: nfo from prepare_h5_upload. **PREREQUISITE: An app MUST be selected first.** This tool reads app info from cache (selected via select_app or create
  • Gives the agent orders in get_debug_feedbacks: -ready debug context files. **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify a
  • Gives the agent orders in get_vibrate_integration_guide: ntensity/震动强度/震动类型. Returns complete step-by-step workflow. CRITICAL: Emphasizes NO SDK installation - tap is global object. Call this BEFORE making any implementation
  • Gives the agent orders in get_code_template: , y) → Optimized position sync - init() → Returns playerId (MUST save it!) - matchRoom() → Match or create room Features: Built-in rate limiting (10/sec), field co
  • Gives the agent orders in get_api_event_table: ⚠️ CRITICAL - API-to-Event relationship table. Shows: Which API call triggers which event, and WHO receives it
  • Gives the agent orders in get_protocol_template: ⚠️ CRITICAL - Communication protocol template to ensure consistency. PURPOSE: Prevent AI from using different
  • Gives the agent orders in get_share_integration_guide: eturns complete step-by-step workflow for TapTap Share API. CRITICAL: Emphasizes NO SDK installation - tap is global object. Use this BEFORE making any implementation p
  • Gives the agent orders in create_share_template: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in list_share_templates: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Gives the agent orders in get_share_template_info: **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ensure an app is selected by calling get_current_app
  • Gives the agent orders in get_ads_integration_workflow: making any implementation plans or writing any ad code. **CRITICAL: For ANY TapTap Minigame/H5 ads-related request, this workflow MUST be followed.** The workflow wil
  • Gives the agent orders in check_ads_status: current selected app's ad space ID. **PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is
  • Very long description in check_ads_status: 2503 characters or more
  • Gives the agent orders in get_ad_integration_guide: automatically resolved ad space ID. **PREREQUISITES (both MUST be met before calling):** 1. check_ads_status has been called and returned status "已生效" (1) 2. A va

Common and usually harmless: it is how many makers stress how a tool should be used.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

get_current_app_info ignore_cache
[General] Get currently selected app/game information including developer_id, app_id, miniapp_id, and app name. **CRITICAL: Call this tool FIRST before executing any leaderboard operations (create_leaderboard, list_leaderboards, etc.) to verify that an app has been selected. If no app is selected, guide the user through the selection process using list_developers_and_apps and select_app.** Use this for: 1) Checking current selection before leaderboard operations, 2) Building preview links, 3) Verifying cached app. Not for H5 upload workflow.
check_environment
Check environment configuration and user authentication status. Use this to verify the current TAPTAP_MCP_ENV, signer mode, TAPTAP_MCP_MAC_TOKEN, and TAPTAP_MCP_CLIENT_ID configuration. If the user asks how to switch between production and RND, call get_environment_switch_guide.
get_environment_switch_guide target_environment, package_tag
[Setup Guide] Explain how to switch this MCP server between production and RND environments from an MCP client configuration. Use this when the user asks to switch environment, use RND, test in RND, configure TAPTAP_MCP_ENV, or asks why RND needs TAPTAP_MCP_CLIENT_ID / TAPTAP_MCP_CLIENT_SECRET. This tool returns client config snippets and agent steps; it does not modify files by itself.
start_oauth_authorization
[Auth] Start OAuth 2.0 Device Code Flow to get authorization URL. Use this when: 1) User explicitly wants to authorize, 2) User needs to login or switch account, 3) Token expired or invalid. Returns a QR code URL for user to scan with TapTap App.
complete_oauth_authorization
[Auth] Complete OAuth authorization after user has scanned QR code. Call this after user confirms they have completed authorization in browser. This tool will poll for the authorization result and save the token.
47 more tools
list_developers_and_apps limit, offset
[General App Management] List developers and apps/games for the current user, including both level games and non-level games. For large accounts, the human-readable response shows a paged preview plus total counts; call again with offset/limit to continue. **CRITICAL: Show the returned preview/counts to the user and explicitly ASK them to choose which app to use or provide app_id/name keywords - DO NOT automatically select an app without user confirmation, even if there is only one option.** Use this for: 1) Initial exploration of available apps, 2) Switching between apps, 3) General app management (not H5 upload workflow). For H5 game upload, use prepare_h5_upload instead.
select_app developer_id, app_id
[General] Select a specific developer and app to use for subsequent operations. Supports both level games and non-level games. This will cache the selection for all modules (leaderboard, H5, current-app community tools, etc.). **IMPORTANT: Only call this tool AFTER the user has explicitly confirmed which app they want to use. DO NOT call this tool automatically without user confirmation.** Use this for: 1) General app selection, 2) Switching accounts, 3) After listing with list_developers_and_apps and receiving user confirmation. For H5 upload, you can also pass developerId/appId to prepare_h5_upload directly.
create_developer
Create a new unverified developer identity on TapTap platform. Use this when user wants to create a new developer account.
create_app developerId, appName, genre
Create a new app/game on TapTap platform. **The newly created app will be automatically selected** - no need to call select_app afterwards. Use this when user wants to create a new app.
update_app_info developerId, appId, appName, genre, description, chattingLabel, chattingNumber, screenOrientation, icon, banner, screenshots, trialNote
Update the app's information on TapTap platform including name, genre, description, icon, banner, screenshots, and more.
get_app_status app_id, ignore_cache
Get the review status of an app/game. Use this to check if the app is published, under review, or rejected.
upload_image filePath, base64Data, filename
Upload an image to TapTap server and get a URL. Use this to upload icon, banner, or screenshots before calling update_app_info. Accepts either a local file path or base64 encoded image data.
clear_auth_data clear_token, clear_cache
Clear all cached authentication data and app selection. Use this when: 1) MAC Token expired or invalid, 2) Want to switch accounts, 3) Need to reset authentication. This will clear both OAuth token file and app cache.
get_current_app_store_overview start_date, end_date
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user confirmation. Get store overview metrics for the currently selected app, including page views, downloads, reserves, download requests, and daily trend data for an optional date range.
get_current_app_review_overview start_date, end_date
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS verify the selected app context. Get review overview metrics for the currently selected app, including rating summary, rating score, positive/neutral/negative review counts, and trend data for an optional date range.
get_current_app_community_overview start_date, end_date
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS verify the selected app context. Get community overview metrics for the currently selected app, including topic count, favorite count, page views, feed count, and trend data for an optional date range.
get_current_app_store_snapshot
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user confirmation. Get a result-oriented store snapshot for the currently selected app, including app card info, current stats, rating summary, 30-day rating trend, version status, and visibility.
get_current_app_forum_contents type, sort, from, limit, group_label_id
**PREREQUISITE: An app MUST be selected first.** Read forum contents for the currently selected app only. Use this to inspect the game forum feed before summarizing community topics. This tool is scoped to the selected app and MUST NOT be used for cross-game browsing.
get_current_app_reviews sort, from, limit, is_collapsed, filter_platform
**PREREQUISITE: An app MUST be selected first.** List reviews for the currently selected app only. Use this before like/reply actions so the user can inspect the review list and confirm the target review_id. Supports sort, pagination, collapsed reviews, and platform filter.
like_current_app_review review_id
**PREREQUISITE: An app MUST be selected first.** Like a specific review for the currently selected app. **IMPORTANT: Before calling this tool, first identify the target review by calling get_current_app_reviews or by showing the exact review to the user, then ASK for confirmation. DO NOT guess the target review_id.** This tool only supports a single review like action.
reply_current_app_review review_id, contents, reply_comment_id, confirm_high_risk
**PREREQUISITE: An app MUST be selected first.** Reply to a specific review as the official app identity. **CRITICAL: Always make sure the user has reviewed and approved the reply content before calling this tool.** The server applies risk grading: LOW can be sent directly, MEDIUM/HIGH usually return a draft and need explicit follow-up confirmation. Only set confirm_high_risk=true after the user explicitly approves sending the risky draft.
get_leaderboard_integration_guide
⭐ READ THIS FIRST when user wants to integrate/接入/setup/add leaderboard功能. Returns complete step-by-step workflow. CRITICAL: Emphasizes NO SDK installation - tap is global object. Call this BEFORE making any implementation plans.
create_leaderboard title, period_type, score_type, score_order, calc_type, display_limit, period_time
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user's choice. Create a new leaderboard on TapTap server. Auto-fetches developer_id and app_id from selected app. Returns leaderboard_id for client-side APIs.
list_leaderboards page, page_size
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user's choice. List all leaderboards for currently selected app. **IMPORTANT: When multiple leaderboards exist, ALWAYS show the complete list to the user and explicitly ASK them which one they want to use - DO NOT automatically choose a leaderboard without user confirmation.**
publish_leaderboard id, publish
**PREREQUISITE: An app MUST be selected first.** Publish leaderboard or set to whitelist-only mode. Before calling this tool, ensure an app is selected by calling get_current_app_info. **IMPORTANT: If the leaderboard ID is not clear, call list_leaderboards first, show the list to the user, and ASK them which leaderboard they want to publish - DO NOT automatically select a leaderboard.**
get_user_leaderboard_scores leaderboardId, limit
Get user leaderboard scores. Requires MAC Token authentication.
prepare_h5_upload gamePath, genre
        [H5 Game Upload Workflow - Step 1]
        Use this tool when user wants to publish/upload/deploy H5 game ('发布', '上传', '部署').

        **PREREQUISITE: An app MUST be selected first.**
        Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected.
        If not selected, guide user through:
        1) Call list_developers_and_apps to show available apps
        2) Show list to user and ASK them to choose
        3) Call select_app with user's choice
        4) Then call this tool

        This tool will:
        1. Verify the game project directory (must contain index.html)
        2. Read app info from cache (selected via select_app)
        3. Return confirmation info for user to review

        After gathering info, use upload_h5_game to upload the game.
      
upload_h5_game gamePath, genre, screenOrientation
        [H5 Game Upload Workflow - Step 2]
        Upload the H5 game to TapTap platform after user confirms info from prepare_h5_upload.

        **PREREQUISITE: An app MUST be selected first.**
        This tool reads app info from cache (selected via select_app or create_app).
        If no app is selected, it will return an error guiding user to select one first.

        **SCREEN ORIENTATION:**
        If the selected app has no screen orientation, this tool will pause before uploading.
        Ask the user to choose 1 (portrait) or 2 (landscape), then call this tool again with
        screenOrientation. DO NOT guess the orientation.
      
get_debug_feedbacks limit, status, fetch_and_mark_processed, download_assets, moment_id
        [H5 Debug Workflow]
        Pull user debug feedback records for the selected app, download artifacts (screenshots/logs),
        and generate AI-ready debug context files.

        **PREREQUISITE: An app MUST be selected first.**
        Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected.
        If not selected, guide user through:
        1) Call list_developers_and_apps to show available apps
        2) Show list to user and ASK them to choose
        3) Call select_app with user's choice
        4) Then call this tool

        **DEFAULT BEHAVIOR:**
        - fetch_and_mark_processed defaults to true
        - download_assets defaults to true
        - downloaded files are saved under logs/feed_back/feedback_{id}/

        **CALLING POLICY FOR AGENTS:**
        - If user says "拉取/查看反馈" without explicit read-only intent, DO NOT pass fetch_and_mark_processed.
          Let default behavior (true) apply.
        - ONLY pass fetch_and_mark_processed=false when user explicitly requests read-only
          behavior (e.g. "只查看,不标记处理").
        - When user provides a moment_id (or a TapTap moment URL), pass it via moment_id param to fetch a single feedback.
          In this case, fetch_and_mark_processed is automatically forced to false (read-only single lookup).
      
get_vibrate_integration_guide
⭐ USE THIS TOOL FIRST when user asks about vibrate/振动/震动/vibration/haptic feedback/触觉反馈 functionality, wants to integrate/接入/setup/add/使用 vibrate功能, searches for vibrate API documentation/文档/教程/示例, asks how to use vibrate/vibrateShort/vibrateLong, needs vibration code examples/代码示例, or asks about vibration intensity/震动强度/震动类型. Returns complete step-by-step workflow. CRITICAL: Emphasizes NO SDK installation - tap is global object. Call this BEFORE making any implementation plans.
get_multiplayer_guide
⭐ PRIMARY entry for multiplayer/多人联机/联网游戏.

CORE CONCEPT: Player A does action → sendData() → Other players receive in onDataReceived() → They see it happen.

Returns: Complete guide with code template. Includes: data sync basics, PlayerId usage, sync strategies, protocol guidelines, API-event relationships, built-in debug logger.

🔧 Built-in features:
- MultiplayerManager template (complete, production-ready)
- Debug logger system (on-screen logs, call get_debug_logger for setup)
- Error codes reference (23 error codes)
- Connection keep-alive
- Message size validation (2048 bytes)

Use when: User wants players to play together, sync game data, see each other's actions.

Perfect for ANY creative H5 game. No game-specific logic needed.
get_code_template
Get complete MultiplayerManager.js template (350+ lines).

Core methods:
- 📤 sendData(data) → Send your action to others
- 📥 onDataReceived(data, fromId) → Receive others' actions
- syncPosition(x, y) → Optimized position sync
- init() → Returns playerId (MUST save it!)
- matchRoom() → Match or create room

Features: Built-in rate limiting (10/sec), field compatibility, offline fallback, change detection.

Copy-paste ready. Use for ANY game type.
get_api_event_table
⚠️ CRITICAL - API-to-Event relationship table.

Shows: Which API call triggers which event, and WHO receives it.

Key relationships AI must understand:
- matchRoom() → You: get roomInfo, Others: get playerEnterRoom event
- sendCustomMessage() → You: NO event, Others: get onCustomMessage event
- updatePlayerCustomProperties() → ALL players (including you): get event

This relationship is hard to show in code template, so use this table when implementing event handlers.

Use when: Implementing multiplayer logic, debugging "why no event triggered?"
get_protocol_template
⚠️ CRITICAL - Communication protocol template to ensure consistency.

PURPOSE: Prevent AI from using different protocols for different features.

COMMON MISTAKE (AI often does this):
- Feature 1: { type: 'click', x, y }
- Feature 2: { action: 'move', pos: {x, y} }  ❌ Inconsistent!

SOLUTION: Define protocol ONCE at project start, reuse for ALL features:
- All messages: { type: string, ...data }
- Consistent structure across all game features

Use when: Starting multiplayer implementation, adding new interaction types.

This is a MAJOR source of bugs - keep protocol consistent!
get_extended_apis
🟡 Get extended APIs quick reference: createRoom, getRoomList, joinRoom, kickRoomPlayer, disconnect, updatePlayerCustomStatus. ONLY use when user explicitly requests room list UI, custom room creation, friend invitation, or player kick functionality. These are OPTIONAL.
get_player_id_guide
🔑 Get Player ID usage guide: how to get local player ID from connect(), check "is this me?", handle field name differences (fromPlayerId/playerId/id). Use when implementing player identification logic or debugging player-related issues.
get_sync_strategy
🎮 Get synchronization strategy guide for joystick/WASD controls and click-based movement. Includes timer-based sync pattern (100ms interval) and change detection. Use when implementing position synchronization or continuous input handling.
generate_local_guide
📄 Generate MULTIPLAYER_GUIDE.md for user project root. Creates persistent reference with API rate limits, playerId rules, data structures. Enables context persistence across conversations. Use at project start.
get_api_data_structures
📊 Get complete API return value structures and event callback data structures. Includes all core APIs (connect, matchRoom, sendCustomMessage, etc) and events (playerEnterRoom, onCustomMessage, etc). Use when implementing API calls to avoid guessing data structures.
generate_multiplayer_code
🎯 One-click: Generate complete multiplayer files ready to save.

Generates:
1. js/MultiplayerManager.js (complete template with comments)
2. MULTIPLAYER_GUIDE.md (quick reference for project)

Returns: File paths and contents, ready to save.

Use when: User wants quick setup, or says "generate multiplayer code/生成多人联机代码".
diagnose_multiplayer_issues
🔍 Diagnose common multiplayer issues.

Use when user reports:
- Players not visible / 看不到其他玩家
- Position not syncing / 位置不同步
- Connection failed / 连接失败
- Data not received / 收不到数据

Returns: Checklist with solutions for each issue.
check_multiplayer_code code
✅ Check multiplayer code before deployment.

Detects:
- Missing rate limiting
- Wrong field names (playerId vs id)
- Missing playerId save
- Uninitialized remote players
- Protocol inconsistency

Use when: Before finalizing code, or when debugging.
get_debug_logger
🔧 Get on-screen debug logger / 屏幕日志系统 / 调试日志工具.

CALL THIS WHEN user says:
- "添加日志工具" / "add logger" / "add debug tool"
- "屏幕日志" / "screen log" / "on-screen log"
- "看不到日志" / "can't see logs" / "无法查看控制台"
- "移动端调试" / "mobile debug" / "手机测试"
- "调试工具" / "debug tool" / "debugging"
- "显示日志在屏幕上" / "show logs on screen"

Features:
- 右下角绿色小圆点 → 点击显示日志面板
- 日志分级 (log/warn/error),自动去重
- 支持复制日志,自动拦截 console
- 移动端友好,非程序员也能用

Returns: DebugLogger setup guide + usage. AI can copy files from /Volumes/Q/MiniGame/Mcp/Tank/DebugLogger to project.

Perfect for: H5 games, mobile testing, non-technical users.
get_share_integration_guide
⭐ READ THIS FIRST when user wants to integrate/接入/setup/add share功能. Returns complete step-by-step workflow for TapTap Share API. CRITICAL: Emphasizes NO SDK installation - tap is global object. Use this BEFORE making any implementation plans. Covers: 1) Server-side template creation workflow, 2) Client-side API usage (tap.showShareboard, tap.onShareMessage), 3) Template code mapping, 4) Audit status checking.
create_share_template developer_id, app_id, contents, remark
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user's choice. Create a new share template on TapTap server for minigame sharing feature. Auto-fetches developer_id and app_id from selected app. Returns template_code which is used in client-side tap.showShareboard() API. **IMPORTANT: contents field has strict 21 UTF-8 character limit (including spaces and punctuation). Template needs audit approval (status=1) before use.**
list_share_templates developer_id, app_id, page, page_size
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ALWAYS call get_current_app_info to verify an app is selected. If not, guide user through: 1) Call list_developers_and_apps, 2) Show list to user and ASK them to choose, 3) Call select_app with user's choice. List all share templates for currently selected app. Auto-fetches developer_id and app_id. Shows template status (0=pending, 1=approved, 2=rejected, 3=audit error). **IMPORTANT: When multiple templates exist, ALWAYS show the complete list to the user and explicitly ASK them which one they want to use - DO NOT automatically choose a template without user confirmation.** NOTE: To modify or delete templates, please use TapTap Developer Center (https://developer.taptap.cn).
get_share_template_info developer_id, app_id, template_code
**PREREQUISITE: An app MUST be selected first.** Before calling this tool, ensure an app is selected by calling get_current_app_info. **IMPORTANT: If the template_code is not clear, call list_share_templates first, show the list to the user, and ASK them which template they want to query - DO NOT automatically select a template.** Get detailed information about a specific share template by template_code. Use this to: 1) Check audit status before using template in client, 2) Get template_code details for tap.showShareboard() API, 3) View audit reason if rejected, 4) Verify template is approved (status=1) before implementation. Returns full template info including status, contents, remark, and audit_reason. NOTE: To modify or delete templates, please use TapTap Developer Center (https://developer.taptap.cn).
search_share_docs query
[Documentation] Search Share API documentation by keyword. Use this when: 1) User asks about share API usage, 2) Need to find specific API documentation (tap.showShareboard, tap.onShareMessage, etc.), 3) Looking for code examples or integration guides. Returns relevant documentation snippets and suggestions.
get_cloud_save_integration_guide
Get complete Cloud Save integration workflow guide for TapTap Minigame and H5 games.

This tool provides:
- Complete workflow for saving and loading game data to/from cloud
- File system operations (writeFile, readFile) for local storage
- Cloud archive operations (create, update, delete, list)
- Error codes and troubleshooting guide
- Best practices and code examples

Use this tool when user asks about:
- How to implement cloud save in their game
- How to save/load game progress to cloud
- Cloud save architecture and workflow
- File system operations for save data
get_ads_integration_workflow
⭐ READ THIS FIRST for TapTap Minigame/H5 ads/广告/ad integration/接入广告/monetization/变现/rewarded video/激励视频/interstitial/插屏/banner requests, or when the product scope is not yet clear.
Do not call this tool when the user or project is already known to be TapTap Maker/UrhoX.

Returns the complete step-by-step ads integration workflow.
Call this BEFORE making any implementation plans or writing any ad code.

**CRITICAL: For ANY TapTap Minigame/H5 ads-related request, this workflow MUST be followed.**
The workflow will guide you through:
1. App selection check
2. Server-side monetization status and ad configuration verification (MANDATORY before integration)
3. Integration code generation (only when status conditions are met)

**MCP PRODUCT SCOPE:**
- This MCP only supports TapTap Minigame/H5 ad integration using the global tap JavaScript APIs.
- It must not be used for TapTap Maker/UrhoX projects.
- If the user or project is Maker/UrhoX, stop and tell the user to switch to the Maker MCP.
- Do not mix tools, app context, ad configuration, IDs, or runtime APIs between these two MCPs.

**AD SPACE ID OWNERSHIP:**
- The latest check_ads_status result for the current selected app is the only source of its ad space ID.
- MUST NOT ask the user for an ad space ID or suggest manually copying one from a console.
- MUST NOT accept a user-provided ID as a fallback.
- MUST NOT reuse an ID from another app, previous output, or existing sample code.
- If multiple apps return the same ID, report only that server fact; do not infer whether the ID is app-specific or shared.
- If automatic lookup cannot return a usable ID, stop and follow the tool's recovery guidance.

This tool has NO prerequisites - call it immediately for an in-scope or not-yet-classified ads topic.
check_ads_status
[Step 2 of Ads Workflow] Check server-side ads monetization status and cache the current selected app's ad space ID.

**PREREQUISITE: An app MUST be selected first.**
Before calling this tool, ALWAYS call get_current_app_info to verify
an app is selected. If not, guide user through app selection process.

Call this tool after confirming the selected app, and call it again when the user explicitly asks
to refresh status after completing an activation step. Do not repeatedly poll it in a loop.

This tool queries the server, updates local cache, and returns:
- Business status: 0=未开通 | 1=已生效 | 2=账号已被封禁
- Ad space ID (space_id) - cached when status is "已生效"
- Guidance URL for activation (if needed)

Status 1 and a valid space_id allow code generation, but do not prove window.tap injection,
ad inventory, package upload correctness, or successful playback on a device.

**CRITICAL - Dual condition for proceeding to Step 3:**
Both conditions MUST be met simultaneously:
1. Status must be "已生效" (status === 1)
2. space_id must be valid (non-empty string)
If status is 1 but space_id is empty → server-side issue, tell user to retry later.

**MCP PRODUCT SCOPE:**
- This MCP only supports TapTap Minigame/H5 ad integration using the global tap JavaScript APIs.
- It must not be used for TapTap Maker/UrhoX projects.
- If the user or project is Maker/UrhoX, stop and tell the user to switch to the Maker MCP.
- Do not mix tools, app context, ad configuration, IDs, or runtime APIs between these two MCPs.

**AD SPACE ID OWNERSHIP:**
- The latest check_ads_status result for the current selected app is the only source of its ad space ID.
- MUST NOT ask the user for an ad space ID or suggest manually copying one from a console.
- MUST NOT accept a user-provided ID as a fallback.
- MUST NOT reuse an ID from another app, previous output, or existing sample code.
- If multiple apps return the same ID, report only that server fact; do not infer whether the ID is app-specific or shared.
- If automatic lookup cannot return a usable ID, stop and follow the tool's recovery guidance.

**Status 0:** Tell user they can say "重新检查广告状态" to refresh after completing activation.
**Status 2 (已封禁):** DO NOT proceed with any integration steps. Immediately inform user.
**Missing screen orientation:** Ask the user to choose 1 (portrait) or 2 (landscape), call
update_app_info with the current developerId/appId and their chosen screenOrientation, then call
check_ads_status again. DO NOT guess the orientation.
get_ad_integration_guide
[Step 3 of Ads Workflow] Get the TapTap Minigame/H5 ads integration guide with the current selected app's automatically resolved ad space ID.

**PREREQUISITES (both MUST be met before calling):**
1. check_ads_status has been called and returned status "已生效" (1)
2. A valid space_id was cached by check_ads_status

If either condition is not met, this tool will return an error with guidance.

This tool reads the cached space_id and generates:
- Complete AdManager.js utility class (full source code with YOUR ad space_id)
- Core focus: Rewarded Video ads (激励视频) - init() + onReward() + showRewardedVideo()
- Optional: Interstitial and Banner ads examples
- Code examples for all common scenarios

**MCP PRODUCT SCOPE:**
- This MCP only supports TapTap Minigame/H5 ad integration using the global tap JavaScript APIs.
- It must not be used for TapTap Maker/UrhoX projects.
- If the user or project is Maker/UrhoX, stop and tell the user to switch to the Maker MCP.
- Do not mix tools, app context, ad configuration, IDs, or runtime APIs between these two MCPs.

**AD SPACE ID OWNERSHIP:**
- The latest check_ads_status result for the current selected app is the only source of its ad space ID.
- MUST NOT ask the user for an ad space ID or suggest manually copying one from a console.
- MUST NOT accept a user-provided ID as a fallback.
- MUST NOT reuse an ID from another app, previous output, or existing sample code.
- If multiple apps return the same ID, report only that server fact; do not infer whether the ID is app-specific or shared.
- If automatic lookup cannot return a usable ID, stop and follow the tool's recovery guidance.

CRITICAL:
- Keep SDK events callback-based; use show/load Promise recovery only for the documented one-time retry
- Provides onReward() callback interface for reward logic
- DO NOT search the web - all information is provided by this tool

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=18.14.1
Sourcegithub.com/taptap/instant-games-open-mcp
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-fZJGmSRd+AxRuv298ZAXgm0I+r7BIqy/aa3ClpjznPQkrLQb+ztdq1QwM6Ifgi1UpngBtxPvTwmXDgyKV3GUpA==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/@taptap/instant-games-open-mcp.svg)](https://bragproof.smaverk.com/r/%40taptap/instant-games-open-mcp)

New version out? Ask for a fresh report.