CUQU找搭子 (CUQU) MCP Server

Official8 tools

by cuqu-net · Python

CUQU找搭子: find & book offline group activities in 10+ China cities; publish your own.

MCP Server: io.github.cuqu-net/cuqu-mcp

The io.github.cuqu-net/cuqu-mcp Model Context Protocol (MCP) server provides functionality for discovering and booking offline group events in more than 10 cities in China. It also supports publishing events, associated with CUQU, for managing event discovery and creation.

🛠️ Key Features

Find offline group events
Book offline group events
Publish your own event
Covers 10+ China cities

🚀 Use Cases

Locate group events in China across 10+ cities
Book an offline group event
Create and publish an event for others to find

⚡ Developer Benefits

Exposes event find, booking, and publishing capabilities via MCP
Uses a CUQU-branded event workflow for offline group events

⚠️ Limitations

Scope is limited to offline group events in 10+ China cities
No additional tools or implementation details provided

Topics

a2aagent-skillsai-agentclaude-skillsllm-toolslocal-activitiesmcpmcp-servershenzhensocialactivity-bookingchinagroup-activitiesmodel-context-protocoloffline-events

Captured live from the server via tools/list.

query_activities

查询粗趣小程序上的活动列表。当用户想找活动、看有什么活动、按条件筛选活动时调用此工具。 Args: activity_type: 活动类型筛选，如"桌游聚会"、"户外徒步"、"剧本杀"、"飞盘"等。留空则不筛选。 date: 日期筛选，格式"2026-08-22"。留空则不筛选。 location: 区域筛选，如"南山区"、"罗湖区"。留空则不筛选。 keyword: 关键词搜索活动标题和描述。留空则不搜索。 Returns: JSON 字符串，包含活动列表（标题、时间、地点、价格、剩余名额、H5 链接等）

Parameters6

activity_type	string	optional
date	string	optional
location	string	optional
keyword	string	optional
district	string	optional	区/县名，如：南山、福田、龙岗、惠东县。与 city 同传时按城市+区两级过滤；支持常见别名（area/zone）。不传则不过滤区
limit	integer	optional	返回条数上限，1-100，默认 50。想看更多就传大一点

Raw schema

{
  "type": "object",
  "properties": {
    "activity_type": {
      "default": "",
      "title": "Activity Type",
      "type": "string"
    },
    "date": {
      "default": "",
      "title": "Date",
      "type": "string"
    },
    "location": {
      "default": "",
      "title": "Location",
      "type": "string"
    },
    "keyword": {
      "default": "",
      "title": "Keyword",
      "type": "string"
    },
    "district": {
      "type": "string",
      "description": "区/县名，如：南山、福田、龙岗、惠东县。与 city 同传时按 城市+区 两级过滤；支持常见别名（area/zone）。不传则不过滤区"
    },
    "limit": {
      "type": "integer",
      "description": "返回条数上限，1-100，默认 50。想看更多就传大一点"
    }
  },
  "title": "query_activitiesArguments"
}

create_activity

主理人在粗趣小程序上发布新活动。当用户（主理人）想创建/发布一个活动时调用此工具。 Args: title: 活动标题，如"周六桌游聚会" activity_type: 活动类型，如"桌游聚会"、"户外徒步"、"剧本杀/密室"等 date: 活动日期，格式"2026-08-22" time: 活动时间段，如"14:00-18:00" location: 活动地点，如"南山区·科兴科学园" max_participants: 最大参与人数，数字字符串或整数均可，如 "15" 或 15 price: 人均费用（元），数字字符串或整数均可，如 "39" 或 39，免费填 "0" 或 0 description: 活动描述和注意事项 organizer: 主理人名称 Returns: JSON 字符串，包含活动 ID 和详情链接

Parameters9

title	string	required
activity_type	string	required
date	string	required
time	string	required
location	string	required
max_participants	any	optional
price	any	optional
description	string	optional
organizer	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "title": "Title",
      "type": "string"
    },
    "activity_type": {
      "title": "Activity Type",
      "type": "string"
    },
    "date": {
      "title": "Date",
      "type": "string"
    },
    "time": {
      "title": "Time",
      "type": "string"
    },
    "location": {
      "title": "Location",
      "type": "string"
    },
    "max_participants": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        }
      ],
      "default": "0",
      "title": "Max Participants"
    },
    "price": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        }
      ],
      "default": "0",
      "title": "Price"
    },
    "description": {
      "default": "",
      "title": "Description",
      "type": "string"
    },
    "organizer": {
      "default": "",
      "title": "Organizer",
      "type": "string"
    }
  },
  "required": [
    "title",
    "activity_type",
    "date",
    "time",
    "location"
  ],
  "title": "create_activityArguments"
}

register_event

用户报名参加活动。当用户确定要报名某个活动时调用此工具。报名后需要完成支付才能锁定名额。 Args: activity_id: 活动 ID（从 query_activities 结果中获取） user_name: 报名人姓名 phone: 手机号（用于接收活动通知和签到） note: 备注，如饮食禁忌、特殊需求等（可选） Returns: JSON 字符串，包含订单号、支付链接和支付二维码 URL

Parameters4

activity_id	string	required
user_name	string	required
phone	string	required
note	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "activity_id": {
      "title": "Activity Id",
      "type": "string"
    },
    "user_name": {
      "title": "User Name",
      "type": "string"
    },
    "phone": {
      "title": "Phone",
      "type": "string"
    },
    "note": {
      "default": "",
      "title": "Note",
      "type": "string"
    }
  },
  "required": [
    "activity_id",
    "user_name",
    "phone"
  ],
  "title": "register_eventArguments"
}

create_payment

生成活动报名的支付链接和二维码。报名后通过此工具获取支付链接，用户扫码或点击链接完成微信支付。 Args: order_id: 订单号（优先使用，从 register_event 结果中获取） activity_id: 活动 ID（无订单号时配合手机号使用） phone: 手机号（配合活动 ID 查找订单） Returns: JSON 字符串，包含支付链接、二维码 URL、支付方式和有效期

Parameters3

order_id	string	optional
activity_id	string	optional
phone	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "default": "",
      "title": "Order Id",
      "type": "string"
    },
    "activity_id": {
      "default": "",
      "title": "Activity Id",
      "type": "string"
    },
    "phone": {
      "default": "",
      "title": "Phone",
      "type": "string"
    }
  },
  "title": "create_paymentArguments"
}

check_in

活动签到。用户到达活动现场后，通过此工具完成签到。支持手机号/用户ID/签到码三种方式。 Args: activity_id: 活动 ID phone: 手机号（用于签到，需与报名时一致） user_id: 用户 ID（已登录用户） code: 签到码（现场扫码获取，或主理人提供的签到口令） Returns: JSON 字符串，包含签到状态和签到时间

Parameters4

activity_id	string	required
phone	string	optional
user_id	string	optional
code	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "activity_id": {
      "title": "Activity Id",
      "type": "string"
    },
    "phone": {
      "default": "",
      "title": "Phone",
      "type": "string"
    },
    "user_id": {
      "default": "",
      "title": "User Id",
      "type": "string"
    },
    "code": {
      "default": "",
      "title": "Code",
      "type": "string"
    }
  },
  "required": [
    "activity_id"
  ],
  "title": "check_inArguments"
}

query_venues

查询粗趣小程序合作场地列表。当用户需要找场地、了解场地信息时调用此工具。 Args: venue_type: 场地类型，如"桌游吧"、"运动场地"、"露营基地"等。留空则不筛选。 location: 区域，如"南山区"、"罗湖区"。留空则不筛选。 min_capacity: 最少容纳人数，整数或数字字符串均可，如 10 或 "10"。填0则不筛选。 Returns: JSON 字符串，包含场地列表（名称、类型、位置、容量、价格区间、设施等）

Parameters3

venue_type	string	optional
location	string	optional
min_capacity	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "venue_type": {
      "default": "",
      "title": "Venue Type",
      "type": "string"
    },
    "location": {
      "default": "",
      "title": "Location",
      "type": "string"
    },
    "min_capacity": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        }
      ],
      "default": "0",
      "title": "Min Capacity"
    }
  },
  "title": "query_venuesArguments"
}

generate_urllink

为小程序页面生成 URL Link（微信外可打开的标准链接）。用户想获得某个页面（通常是活动详情页）的可分享链接时调用。生成的 https://wxaurl.cn/ 链接可在短信、邮件、网页、AI 应用等微信外场景打开，点击后唤起微信小程序对应页面。 Args: activity_id: 活动 ID。提供时自动映射到活动详情页（path=pages/activity/detail, query=id=xxx）。 path: 小程序页面路径，如 "pages/index/index"。提供 activity_id 时忽略。 query: 页面参数（urlencode 后的字符串），如 "id=act_001"。提供 activity_id 时忽略。 Returns: JSON 字符串，包含 URL Link、页面路径和参数

Parameters3

activity_id	string	optional
path	string	optional
query	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "activity_id": {
      "default": "",
      "title": "Activity Id",
      "type": "string"
    },
    "path": {
      "default": "",
      "title": "Path",
      "type": "string"
    },
    "query": {
      "default": "",
      "title": "Query",
      "type": "string"
    }
  },
  "title": "generate_urllinkArguments"
}

get_activity_card

获取活动的"卡片"数据（C 端工具包核心）。当用户想直接看到某活动的小程序卡片（标题 + 封面 + 时间地点 + 价格 + 报名链接）时调用此工具。返回的卡片包含： - url_link: 小程序 URL Link（微信外点击唤起小程序活动页） - h5_url: H5 活动页地址（AI 应用内直接打开） Args: activity_id: 活动 ID Returns: JSON 字符串，包含活动卡片数据

Parameters1

activity_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "activity_id": {
      "title": "Activity Id",
      "type": "string"
    }
  },
  "required": [
    "activity_id"
  ],
  "title": "get_activity_cardArguments"
}

README.md3 KBView on GitHub

CUQU找搭子 (CUQU) MCP Server

smithery badge

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

bash

# 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:

json

{
  "mcpServers": {
    "cuqu": {
      "command": "python",
      "args": ["-u", "/path/to/server.py"],
      "env": { "CUQU_API_KEY": "cq-sk-...(optional, enables write tools)" }
    }
  }
}

License

Install

Tools (8)

query_activitiescreate_activityregister_eventcreate_paymentcheck_inquery_venuesgenerate_urllinkget_activity_card

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agent.cuqu.net/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "cuqu-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agent.cuqu.net/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.cuqu-net/cuqu-mcp

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

query_activities

create_activity

register_event

create_payment

check_in

query_venues

generate_urllink

get_activity_card

CUQU找搭子 (CUQU) MCP Server

What this repository contains

Tools

Quick start

License

Install

Remote endpoint

Related servers