Douyin Mini-Game MCP. Manage game state, scores, and user content via API calls.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Douyin Mini-Game MCP Server connects your AI agent directly to the Douyin Open Platform API. Use it to manage the backend of casual games—handle user sessions, save progress to cloud storage, submit scores to leaderboards, and moderate user-generated content.
It’s your full toolkit for game state management and analytics.
What your AI agents can do
Check content security
Checks user-generated text against Douyin's policies, reporting if the content is safe or violates rules.
Code2session
Exchanges a temporary login code for a permanent user session token (openid/session_key).
Get access token
Retrieves the necessary server access token required for all subsequent API calls.
Exchanges a temporary login code for a permanent user session token (openid and session_key).
Saves or retrieves key-value pairs for user data, including scores, settings, and game levels.
Submits a score to a specific leaderboard or retrieves a player's current rank and standing.
Scans user-submitted text against Douyin's content policies to find prohibited material.
Pulls aggregate data on Daily Active Users (DAU) and player retention rates.
Gets basic player information like their nickname and avatar using their unique user ID.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Douyin Mini-Game MCP Server: 10 Tools for Game Backend Control
These tools let your agent manage every piece of the mini-game backend: from user logins and data storage to calculating ranks and filtering content.
019d8430check content security
Checks user-generated text against Douyin's policies, reporting if the content is safe or violates rules.
019d8430code2session
Exchanges a temporary login code for a permanent user session token (openid/session_key).
019d8430get access token
Retrieves the necessary server access token required for all subsequent API calls.
019d8430get analytics
Pulls game performance metrics like DAU and retention rates to analyze player engagement.
019d8430get game rank
Retrieves a user's current standing and full leaderboard data for a specified game mode.
019d8430get user info
Retrieves basic profile details for a Douyin user, such as their nickname and avatar.
019d8430get user storage
Retrieves stored key-value data for a user, such as game progress or settings, from the cloud.
019d8430remove user storage
Deletes specific keys from a user's cloud storage to reset game progress or remove old data.
019d8430set user storage
Saves key-value data for a user, used to persist game progress, high scores, or user preferences.
019d8430submit score
Records a numeric score to a specified leaderboard, affecting the user's rank.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Douyin Mini-Game, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Yo, this Douyin Mini-Game MCP Server connects your AI agent straight to the Douyin Open Platform API. It lets you handle the whole backend for casual games—user sessions, saving progress, submitting scores, and moderating content. It's your full toolkit for managing game state and getting analytics.
Manage User Sessions: You can use code2session to swap a temporary login code for a permanent user session token, giving you the necessary openid and session_key.
Save/Load Game Progress: You'll use get_user_storage to pull stored key-value data—think game progress or user settings—and set_user_storage to save it. If you gotta wipe the slate clean, remove_user_storage deletes specific keys from a user's cloud storage.
Track Player Rankings: submit_score records a numeric score to a specific leaderboard, which changes the user's rank. You can check a player's standing and the whole leaderboard data with get_game_rank.
Check Content Safety: Before a user posts anything, you run check_content_security to scan their text against Douyin's policies. This tool tells you if the content is safe or if it violates rules.
Analyze Game Performance: You pull aggregate data on Daily Active Users (DAU) and player retention rates using get_analytics.
Retrieve User Details: Need basic player info? get_user_info grabs a user's nickname and avatar based on their unique ID. You first gotta get the necessary server access token with get_access_token for all these calls.
How Douyin Mini-Game MCP Works
- 1 First, your AI agent calls
get_access_tokento get a valid server access token. This token is required for everything else. - 2 Next, you use the token to authenticate the user, typically by calling
code2sessionwith a login code. This establishes the user's unique session ID. - 3 Finally, you execute your required action—maybe
set_user_storageto save progress, orsubmit_scoreto update a rank—using the established session context.
The bottom line is that the server manages the entire lifecycle: getting credentials, authenticating the user, and executing the specific state change.
Who Is Douyin Mini-Game MCP For?
Game Developers need this when they can't rely on manual database calls or siloed analytics dashboards. Content Moderators need it to enforce policy before anything goes live. Analytics Teams need a single API source for tracking DAU and retention trends without building complex middleware.
Uses set_user_storage and get_user_storage to persist player data (scores, settings) and submit_score to maintain leaderboards.
Calls get_analytics to track player engagement and identify where retention rates are dropping, informing the next game feature.
Runs check_content_security on all user-generated text to ensure policy compliance before publishing content.
What Changes When You Connect
- Saves development time by centralizing data management. Instead of writing separate code paths for analytics, leaderboards, and storage, you use dedicated tools like
get_analytics,get_game_rank, andset_user_storage. - Maintains data integrity by forcing proper authentication. You must call
get_access_tokenand thencode2sessionbefore any write operation, preventing unauthorized state changes. - Ensures content safety. Before allowing a user to publish text, the agent runs
check_content_security, preventing policy violations from reaching the live game. - Handles user data persistence reliably.
set_user_storageandget_user_storagemanage all key-value data—from high scores to cosmetic settings—in one place. - Provides deep insights into player behavior. Use
get_analyticsto track DAU and retention trends, giving product teams hard data on game health. - Streamlines competitive features.
submit_scorehandles score submission and ranking logic, keeping your leaderboards accurate without custom backend work.
Real-World Use Cases
Player data needs a hard reset.
A user quits the game and needs all their old data cleared. The agent calls remove_user_storage using the user's session ID. This reliably wipes all stored keys, including settings and scores, ensuring a clean slate for the next session.
A new leaderboard needs testing.
The Product Manager needs to see how a new scoring system impacts the top 100 players. They use submit_score to populate the leaderboard with test data and then immediately call get_game_rank to verify the data structure and ranking logic.
Checking user-generated chat messages.
A moderator receives a report of suspicious chat text. They pass the text to check_content_security. If the tool returns a violation, the agent blocks publication and alerts the user.
Onboarding a new user for the first time.
The game client first runs get_access_token, then uses code2session to authenticate the user. Finally, it calls set_user_storage to write initial default settings and a starting progress level.
The Tradeoffs
Treating all data as simple keys
Attempting to store complex, nested user data (e.g., a full inventory list) in a single string key-value field, making retrieval difficult or impossible.
→
Structure your data payload into distinct, meaningful keys (e.g., inventory_list, current_level, settings_theme). Use set_user_storage and get_user_storage for granular control over specific data types.
Ignoring the authentication flow
Calling set_user_storage directly with a user ID without first running get_access_token and code2session to establish a valid session.
→
Always start by establishing the session. First, get the token via get_access_token, then use code2session to get the session key. Only then can you write state using set_user_storage.
Using tools for non-game tasks
Using get_analytics to find out what a specific user did last week, instead of checking the user's profile directly.
→
Remember the scope. get_analytics shows aggregate trends (DAU, retention). If you need specific user data, use get_user_info or get_user_storage.
When It Fits, When It Doesn't
Use this server if your game needs centralized state management across multiple functions: user profiles, high scores, and content filtering. It's essential for any casual game with persistent user data or competitive features. Don't use it if you only need a simple, isolated API endpoint (e.g., just fetching a public list of global scores). If you only need to fetch global data, a simple read-only service might suffice. But if you need to save data, check content, or track user journeys, you need the full suite of tools here.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Douyin Mini-Game. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Managing game data feels like jumping between five different admin dashboards.
Right now, updating a user's score means hitting the leaderboard API, but changing their profile picture requires a separate user profile service call. Saving game progress usually means hitting a dedicated key-value store, and tracking engagement means logging into a third-party analytics tool. It's a mess of copy-pasting IDs and switching context.
With this MCP server, your agent handles the complexity. You send a single instruction—'Update user X's score and save their progress.' The agent manages the sequence: it authenticates the user, calls `submit_score`, and then calls `set_user_storage`—all in one go. You just get the result.
Douyin Mini-Game MCP Server: Manage user content safety.
Before publishing any user chat message or nickname, the manual process is: the message goes through a pre-check form, you copy the text, paste it into a separate moderation tool, wait for the result, and then manually tag it as approved or rejected.
Now, your agent integrates the check directly. It runs `check_content_security` on the text in real-time. If it finds a violation, the agent stops the process immediately and tells the user it's blocked. It's a hard gate, not a suggestion.
Common Questions About Douyin Mini-Game MCP
How do I use the Douyin Mini-Game MCP Server to save high scores? +
You use the set_user_storage tool. This tool saves data using a key-value pair, and you pass the user's unique session ID as the identifier. The score is simply one of the keys you save.
What do I need before I can use the Douyin Mini-Game MCP Server tools? +
You must first call get_access_token to get a server access token. Then, you use code2session with a login code to establish the user session necessary for all write operations.
Is `get_user_info` the same as `get_user_storage`? +
No. get_user_info pulls basic profile data (like nickname). get_user_storage pulls data you stored in the cloud, like game progress or settings. They track different things.
How do I reset a user's game progress? +
Run the remove_user_storage tool. You just need to specify the user's session ID and the specific keys you want to delete (e.g., settings,score).
Can I check content using the Douyin Mini-Game MCP Server outside of a game? +
Yes. check_content_security works on any user-generated text you provide. It doesn't require a game session to run its policy check.
How do I exchange a login code for a user session using the `code2session` tool? +
You pass the code to code2session to establish a user session. This action exchanges the temporary login code for persistent openid and session_key credentials, which you need for all other API calls.
What is the difference between `get_user_info` and `get_user_storage`? +
They retrieve different kinds of data. get_user_info gets profile details like nicknames and avatars. get_user_storage fetches specific, persistent data saved by the user, like game scores or settings.
Can I use `get_analytics` to track player retention rates? +
Yes, get_analytics tracks performance metrics, including DAU and retention rates. You pass the required time range parameters to analyze how many users return over time.
How do I get my Douyin Mini-Game App ID and Secret? +
Register at the Douyin Open Platform, create a mini-game application, and find your App ID and Secret in the application settings. You'll need entity verification for production deployment.
What is cloud storage used for? +
Cloud storage saves user game data (progress, settings, high scores) as key-value pairs. Each user gets their own storage space. Use setUserStorage to save data and getUserStorage to load it. This is essential for cross-device game continuity.
How does content moderation work? +
The content security API checks user-generated text (nicknames, chat, custom names) against Douyin's content policies. Submit text via the check_content_security tool and receive a pass/fail result. This is mandatory for games with user-generated content features.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
NVIDIA API Catalog
Cloud Engine proxy running native foundational completions natively utilizing active Nemotron and Llama3 architectures.
Meituan Waimai Open API / 美团外卖
China's leading food delivery platform — manage store operations, orders, and delivery tracking via AI.
PassKit
Create digital passes for Apple Wallet and Google Pay with loyalty cards, coupons, and event tickets that update in real time.
You might also like
GitScrum ClientFlow
Streamline client operations via GitScrum ClientFlow — manage clients, create invoices, draft proposals, and monitor project budgets directly from any AI agent.
Outlier Detection Engine
Identify statistical anomalies in massive datasets local using deterministic Z-Score and IQR methods. Stop LLMs from guessing which rows are outliers.
EZO Asset Intelligence
Equip your AI agent to manage fixed assets, track inventory, and monitor checkouts via the EZO.io (EZOfficeInventory) API.