CUQU MCP server
Commit Oct 3, 2026Lets AI agents discover, book, and manage offline group activities and social events across various cities in China.
Also known as cuqu-net/cuqu-skill, cuqu-skill
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Oct 3, 2026
- License
- MIT
What is CUQU MCP?
CUQU lets AI agents discover, book, and manage offline group activities and social events across various cities in China. It exposes 8 tools, such as query_activities, get_activity_card, query_venues.
Summary generated from the project's README
About CUQU MCP server
Finding and booking offline social activities in China is what this MCP server enables for AI agents. It provides live access to the CUQU platform, which covers over ten cities including Hong Kong and Shenzhen. Users can interact with real-time data for more than 100 activity categories such as board games, hiking, badminton, and fishing.
Developers can run this server locally using Python or via Docker. While read tools like query_activities and query_venues do not require authentication, performing write actions requires a specific CUQU_API_KEY starting with the cq-sk- prefix. These write tools allow an agent to manage the entire event lifecycle, from publishing a new event with create_activity to handling bookings and payments.
The server uses JSON-RPC 2.0 over stdio to communicate with clients like Claude Desktop. It bridges the gap between digital AI assistants and physical social gatherings by providing tools to check venue capacity, generate WeChat mini-program links, and process on-site check-ins.
What you can do with it
- 1Discover local group activitiesAsk an AI agent to find hiking or board game events happening in a specific city this weekend.
Written from the project's README. Every use case is checked against a quote from it.
How to install CUQU MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CUQU MCP in Claude Code
$ claude mcp add --transport http cuqu-skill https://agent.cuqu.net/mcpInstall CUQU MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cuqu-skill": {
"url": "https://agent.cuqu.net/mcp"
}
}
}Install CUQU MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cuqu-skill": {
"type": "http",
"url": "https://agent.cuqu.net/mcp"
}
}
}Install CUQU MCP in VS Code CLI
$ code --add-mcp '{"name":"cuqu-skill","type":"http","url":"https://agent.cuqu.net/mcp"}'Install CUQU MCP in Codex
$ codex mcp add cuqu-skill --url https://agent.cuqu.net/mcpInstall CUQU MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cuqu-skill] url = "https://agent.cuqu.net/mcp"
Install CUQU MCP in Gemini CLI
$ gemini mcp add -s user --transport http cuqu-skill https://agent.cuqu.net/mcpInstall CUQU MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cuqu-skill": {
"url": "https://agent.cuqu.net/mcp",
"type": "http"
}
}
}CUQU MCP tools 8
Detected from the READMEquery_activitiesget_activity_cardquery_venuesgenerate_urllinkcreate_activityregister_eventcreate_paymentcheck_in
| query_activities | — | |
| get_activity_card | — | |
| query_venues | — | |
| generate_urllink | — | |
| create_activity | — | |
| register_event | — | |
| create_payment | — | |
| check_in | — |
Configuration
CUQU_API_KEY
| Name | Description | |
|---|---|---|
| CUQU_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecuqu-net/cuqu-skill is public and reachablegithub.com/cuqu-net/cuqu-skill ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-03github.com/cuqu-net/cuqu-skill ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 65 msPass
README
View on GitHubCUQU找搭子 (CUQU) MCP Server
Open-source MCP server giving AI agents live access to CUQU (找搭子) — a local offline social activities platform in China (Shenzhen-based, 10+ cities incl. Hong Kong, China). Users discover and book offline interest-based group activities (board games, frisbee, hiking, badminton, fishing, anime and 100+ more categories); organizers publish and run events.
Live demo endpoint (hosted): https://agent.cuqu.net/mcp (Streamable HTTP, per-user cq-sk- keys — see llms.txt)
Agent Card: https://cuqu.net/.well-known/agent.json
Talk to the agents (chat UI):
- Baidu Qianfan: https://appbuilder.baidu.com/s/w93d7Z6X (Chinese)
- iFlytek Astron: https://agent.xfyun.cn/agentbuilder/chat?sharekey=998b5236b21fb85e005b9c9438f78b10&botId=5830291 (Chinese; API flow_id
7510896245077958656) - Live weekly activities: https://cuqu.net/activities/list/ (real in-stock data, updated daily)
- IRL Activity Schema v0.1 (CC BY 4.0): https://cuqu.net/schema/irl-activity/v0.1/irl-activity-schema.json
What this repository contains
| Path | What it is |
|---|---|
server.py |
The MCP server implementation — zero-dependency Python, JSON-RPC 2.0 over stdio. Read tools call CUQU's public live activity API; write tools forward to the hosted gateway with a user key. |
Dockerfile |
One-command container build for the server (glama.ai / docker / any MCP host). |
glama.json |
glama.ai directory metadata & maintainership. |
scripts/check-mcp.py |
Connectivity check for the hosted gateway. |
skills/, docs/ |
Agent skill manifests and platform integration docs (Qwen/Dify/Yuanqi). |
Tools
8 tools across the activity lifecycle:/n
| Tool | Type | Description |
|---|---|---|
query_activities |
read (no key) | Search live activities by type / city / date — 100+ categories, real-time public data |
get_activity_card |
read (no key) | Full detail card for one activity (time, venue, price, booking progress, organizer, cover) |
query_venues |
read (no key) | Curated partner venue directory (capacity, per-head price) |
generate_urllink |
read (no key) | Share link + WeChat mini-program path for an activity |
create_activity |
write (key) | Organizer publishes a new event |
register_event |
write (key) | Book a user into an activity |
create_payment |
write (key) | Create WeChat Pay for a booking order |
check_in |
write (key) | On-site check-in / redemption |
Write tools are executed by the hosted gateway and require CUQU_API_KEY (cq-sk-..., issued via scan-to-issue flow documented in llms.txt).
Quick start
# stdio, zero dependencies, Python 3.9+
python -u server.py
# or via Docker
docker build -t cuqu-mcp .
docker run -i cuqu-mcp
Claude Desktop / any stdio MCP client:
{
"mcpServers": {
"cuqu": {
"command": "python",
"args": ["-u", "/path/to/server.py"],
"env": { "CUQU_API_KEY": "cq-sk-...(optional, enables write tools)" }
}
}
}
License
MIT — © 2026 光天科技（深圳）有限公司 (Guangtian Technology (Shenzhen) Co., Ltd.)
CUQU MCP questions
How do I add CUQU MCP to Claude Code?
Run claude mcp add --transport http cuqu-skill https://agent.cuqu.net/mcp in your terminal. Add --scope user to make it available in every project.
How do I add CUQU MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does CUQU MCP provide?
It exposes 8 tools, including query_activities, get_activity_card, query_venues, generate_urllink, create_activity.
What kind of activities can I find on CUQU?
You can discover and book over 100 categories of interest-based group activities, including board games, frisbee, hiking, badminton, fishing, and anime.
Do I need an API key to search for activities?
No, read tools like searching for activities or getting activity details do not require an API key.
How do I publish or book an event using the server?
To publish a new event or register for one, you must use a write tool and provide a CUQU_API_KEY.