CUQU (找搭子) MCP Server
MCP serverDev toolsFind and book offline group events in 10+ China cities, or publish your own event. By CUQU.
Available today. Use it from your connected AI after setup.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use CUQU (找搭子) MCP Server to query activities
Install CUQU (找搭子) MCP Server
The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user cuqu-mcp-server 'https://agent.cuqu.net/mcp'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://agent.cuqu.net/mcpAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=cuqu-mcp-server&config=eyJ1cmwiOiJodHRwczovL2FnZW50LmN1cXUubmV0L21jcCJ9Open the link and Cursor adds the server at that address.
ChatGPT
https://agent.cuqu.net/mcpIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add cuqu-mcp-server --url 'https://agent.cuqu.net/mcp'Run it once, then sign in with codex mcp login cuqu-mcp-server if the server asks for an account.
From the project's README
As published by cuqu-net/cuqu-skill in README.md.
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
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)
| 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.)
Tools it offers (8)
What this server listed when ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.
query_activitiescreate_activityregister_eventcreate_paymentcheck_inquery_venuesgenerate_urllinkget_activity_card
Signals
- Last commit
- Sep 2026
Advanced
- Delivery
- cuqu-mcp MCP server → your ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
io-github-cuqu-net-cuqu-mcp- Source
- github.com/cuqu-net/cuqu-skill
- Hosted endpoint
https://agent.cuqu.net/mcp