CUQU (找搭子) MCP Server

MCP serverDev tools

Find 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.

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/mcp

    Add 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=eyJ1cmwiOiJodHRwczovL2FnZW50LmN1cXUubmV0L21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://agent.cuqu.net/mcp

    In 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

PathWhat it is
server.pyThe 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.
DockerfileOne-command container build for the server (glama.ai / docker / any MCP host).
glama.jsonglama.ai directory metadata & maintainership.
scripts/check-mcp.pyConnectivity check for the hosted gateway.
skills/, docs/Agent skill manifests and platform integration docs (Qwen/Dify/Yuanqi).

Tools (8)

ToolTypeDescription
query_activitiesread (no key)Search live activities by type / city / date — 100+ categories, real-time public data
get_activity_cardread (no key)Full detail card for one activity (time, venue, price, booking progress, organizer, cover)
query_venuesread (no key)Curated partner venue directory (capacity, per-head price)
generate_urllinkread (no key)Share link + WeChat mini-program path for an activity
create_activitywrite (key)Organizer publishes a new event
register_eventwrite (key)Book a user into an activity
create_paymentwrite (key)Create WeChat Pay for a booking order
check_inwrite (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_activities
  • create_activity
  • register_event
  • create_payment
  • check_in
  • query_venues
  • generate_urllink
  • get_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