CUQU (找搭子) MCP Server

io.github.cuqu-netv1.0.0Updated Sep 28, 2026

Find and book offline group events in 10+ China cities, or publish your own event. By CUQU.

VerifiedStreamable HTTPWeb executableCloud & Infrastructure

Installation

In SourceWeft

  1. Open CUQU (找搭子) MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cuqu-mcp": {
      "type": "http",
      "url": "https://agent.cuqu.net/mcp"
    }
  }
}

README

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

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

bash
# stdio, zero dependencies, Python 3.9+python -u server.py
# or via Dockerdocker build -t cuqu-mcp .docker run -i cuqu-mcp

Claude Desktop / any stdio MCP client:

json
{  "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.)

Source: README.md at commit 1346d29

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 28, 2026