CUQU找搭子 (CUQU) MCP Server
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http cuqu-cuqu-mcp-server 'https://agent.cuqu.net/mcp'{
"mcpServers": {
"cuqu-cuqu-mcp-server": {
"type": "http",
"url": "https://agent.cuqu.net/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
CUQU找搭子 (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-mcpClaude 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.)
Frequently asked questions
What is CUQU找搭子 (CUQU) MCP Server?
CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.
How do I install CUQU找搭子 (CUQU) MCP Server?
It runs as a remote server. In Claude Code: claude mcp add --transport http cuqu-cuqu-mcp-server 'https://agent.cuqu.net/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does CUQU找搭子 (CUQU) MCP Server need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is CUQU找搭子 (CUQU) MCP Server open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains CUQU找搭子 (CUQU) MCP Server?
It is published by cuqu-net. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.